Bakiye Mutabakatı
Kampanya Listeleme(listCampaigns)
GET/balance-campaigns
Kampanyaları listele
Son güncelleme: 21 Eylül 2026 · Sözleşme sürümü 1.0.0
İmleçli liste. Panelden açılan kampanyalar da görünür (external_id boş); sihirbazın henüz kaydedilmemiş ara taslakları listeye girmez (panel listesiyle aynı kural).
Servis
| Metot | GET |
| Adres | https://mutabakat.ai/api/v1/balance-campaigns |
| Kapsam | balance:read |
| Idempotency-Key | Kullanılmaz |
| dry_run | Yok |
İstek Parametreleri
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| limit (sorgu) | integer | Hayır | Sayfa boyu (≤500) |
| cursor (sorgu) | string | Hayır | Önceki next_cursor |
| updated_since (sorgu) | string (date-time) | Hayır | ISO 8601 |
| status (sorgu) | "draft" | "active" | "completed" | "cancelled" | Hayır | draft | active | completed | cancelled |
| external_id (sorgu) | string | Hayır | ERP belge numarası |
Yanıt
200Liste (imleçli)
| Alan | Tür | Açıklama |
|---|---|---|
| data | Campaign[] | |
| data[].id | string (uuid) | |
| data[].external_id | string | null | ERP belge/parti numarası (org içinde benzersiz) |
| data[].title | string | |
| data[].period_date | string | Mutabakat tarihi (YYYY-MM-DD) |
| data[].response_deadline | string (date-time) | Son yanıt tarihi (ISO 8601 zaman damgası; gün sonu TR) |
| data[].currency | string | |
| data[].sender_company_name | string | null | Davet e-postasında görünen gönderen adı |
| data[].status | "draft" | "active" | "completed" | "cancelled" | |
| data[].awaiting_first_send_approval | boolean | Anahtarın ilk gönderimi panelde onay bekliyor (202 sonrası). |
| data[].summary | object | |
| data[].summary.total | integer | |
| data[].summary.draft | integer | |
| data[].summary.sent | integer | |
| data[].summary.viewed | integer | |
| data[].summary.agreed | integer | |
| data[].summary.disputed | integer | |
| data[].summary.comparing | integer | |
| data[].summary.compared | integer | |
| data[].summary.no_response | integer | |
| data[].completed_at | string | null (date-time) | |
| data[].created_at | string | null (date-time) | |
| data[].updated_at | string | null (date-time) | |
| next_cursor | string | null | Sonraki sayfa imleci; son sayfada null. |
| request_id | RequestId |
Hata Kodları
Bu uç için dönebilecek HTTP durumları: 400 · 401 · 403 · 429 · 500 · 503. Zarf biçimi ve kod listesi için Hata Kodları sayfasına bakın.
Örnek İstek
curl -X GET https://mutabakat.ai/api/v1/balance-campaigns \
-H "Authorization: Bearer $MAI_API_KEY"