API — Alerte

GET /alerts

Returnează alertele generate pentru contul tău, ordonate descrescător după dată.

Request:

GET /alerts?unread=true&page=1&limit=20
Authorization: Bearer <access_token>

Parametri de interogare:

Parametru	Tip	Descriere
unread	boolean	true — returnează doar alertele necitite
watchlistId	string	UUID — filtrare după watchlist specific
verdict	string	GO, RESEARCH, SKIP
dateFrom	string	ISO 8601 — alerte generate după această dată
page	integer	Pagina curentă (default: 1)
limit	integer	Rezultate per pagină (default: 20, max: 100)

Răspuns de succes (200):

{
  "data": [
    {
      "id": "uuid-alerta",
      "tenderId": "uuid-licitatie",
      "tenderTitle": "Reabilitare drum județean DJ123",
      "score": 82,
      "verdict": "GO",
      "watchlistId": "uuid-watchlist",
      "watchlistName": "Client Constructii SRL",
      "read": false,
      "createdAt": "2026-05-08T10:35:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 12,
    "totalPages": 1
  }
}

---

PATCH /alerts/:id

Actualizează starea unei alerte (marcare ca citită sau necitită).

Request:

PATCH /alerts/uuid-alerta
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "read": true
}

Răspuns de succes (200): obiectul alertă actualizat.

---

PATCH /alerts/mark-all-read

Marchează toate alertele necitite ca citite.

Request:

PATCH /alerts/mark-all-read
Authorization: Bearer <access_token>

Răspuns de succes (200):

{
  "data": {
    "updated": 12
  }
}

---

Erori frecvente

Cod	Cauză
404	Alerta nu există sau nu îți aparține

Vezi și

• Funcționalitate Alerte
• Licitații API