API — Licitații

Disponibil: plan Consultant · Autentificare: API Key

GET /api/v1/tenders

Returnează lista paginată de licitații scorificate pentru o companie din tenant-ul tău.

Request:

GET /api/v1/tenders?companyId={uuid}&limit=20&minScore=50
Authorization: Bearer scopo_<cheie>

Parametri de interogare:

Parametru	Tip	Obligatoriu	Descriere
companyId	string	✓	UUID — compania pentru care vrei scorurile
minScore	integer	—	Scor minim (0–100); default: 0
limit	integer	—	Rezultate per pagină (1–100); default: 20
cursor	string	—	Cursor opac din meta.next_cursor (paginare)

Răspuns de succes (200):

{
  "data": [
    {
      "tender_id": "uuid",
      "title": "Servicii de mentenanță software pentru...",
      "score": 87,
      "verdict": "GO",
      "cpv_codes": ["72212000-4"],
      "contracting_authority": "Primăria Municipiului Focșani",
      "deadline": "2026-08-15T23:59:59Z",
      "estimated_value_ron": 450000,
      "estimated_value_eur": 90400,
      "publish_date": "2026-06-18T09:00:00Z",
      "source_url": "https://sicap-prod.e-licitatie.ro/..."
    }
  ],
  "meta": {
    "total": 47,
    "limit": 20,
    "next_cursor": "eyJsYXN0U2NvcmUiOjg3LCJsYXN0SWQiOiJ1dWlkIn0=",
    "has_more": true,
    "credits": {
      "cost": 20,
      "remaining": 1480,
      "period_ends_at": "2026-07-01T00:00:00+03:00"
    }
  }
}

Paginare cursor:

# Primul apel
curl "https://api.scopo.ro/api/v1/tenders?companyId=uuid&limit=20" \
  -H "Authorization: Bearer scopo_..."

# Pagina următoare — folosește next_cursor din răspunsul anterior
curl "https://api.scopo.ro/api/v1/tenders?companyId=uuid&limit=20&cursor=eyJsYXN..." \
  -H "Authorization: Bearer scopo_..."

Cursorul este stabil: licitații noi apărute în timp ce paginezi nu afectează ordinea paginilor anterioare.

Cost credite: 1 credit × număr de tenders din data[]

---

GET /api/v1/tenders/:id/score

Returnează breakdown-ul complet al factorilor de scoring pentru o licitație.

Request:

GET /api/v1/tenders/uuid-licitatie/score?companyId=uuid-companie
Authorization: Bearer scopo_<cheie>

Parametri:

Parametru	Tip	Obligatoriu	Descriere
companyId	string	✓	UUID — compania din tenant-ul tău

Răspuns de succes (200):

{
  "tender_id": "uuid",
  "overall_score": 87,
  "overall_confidence": 0.85,
  "verdict": "GO",
  "factors": {
    "semantic": { "score": 0.92, "weight": 0.35, "contribution": 32 },
    "keyword": { "score": 0.78, "weight": 0.25, "contribution": 20 },
    "cpv": { "score": 0.85, "weight": 0.2, "cpv_type": "primary", "contribution": 17 },
    "value_fit": { "score": 0.8, "weight": 0.1, "contribution": 8 },
    "historical": { "score": 0.65, "weight": 0.1, "contribution": 7 }
  },
  "scoring_model_version": "scoring-v2-adjacent",
  "scored_at": "2026-06-18T08:45:00Z"
}

Cost credite: 2 credite per apel

---

Erori frecvente

Cod	Eroare	Cauză
401	API_KEY_INVALID	Cheie lipsă, invalidă sau revocată
403	COMPANY_ACCESS_DENIED	companyId nu aparține tenant-ului cheii tale
403	PLAN_UPGRADE_REQUIRED	Plan < Consultant
404	—	Licitația nu există sau nu aparține companiei tale
429	RATE_LIMIT_EXCEEDED	Depășit 60 req/min; verifică Retry-After din header
402	API_CREDITS_EXHAUSTED	Credite epuizate pentru luna curentă

---

Vezi și

• Export CSV/JSON — bulk export pentru analiză BI
• Scoring și Go/No-Go — cum se calculează scorul
• Credite API — model de consum
• Erori API — referință completă