Cari Rehberi
Cari Listeleme(listCounterparties)
GET/counterparties
Carileri listele
Son güncelleme: 21 Eylül 2026 · Sözleşme sürümü 1.0.0
İmleçli liste (updated_at, id artan). Değişen kayıtları çekmek için updated_since + cursor.
Servis
| Metot | GET |
| Adres | https://mutabakat.ai/api/v1/counterparties |
| Kapsam | counterparties:read |
| Idempotency-Key | Kullanılmaz |
| dry_run | Yok |
İstek Parametreleri
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| limit (sorgu) | integer | Hayır | Sayfa boyu (varsayılan 100, en çok 500) |
| cursor (sorgu) | string | Hayır | Önceki yanıtın next_cursor değeri |
| updated_since (sorgu) | string (date-time) | Hayır | ISO 8601; bu andan sonra güncellenenler |
| external_id (sorgu) | string | Hayır | Tek cari (ERP kodu) |
| q (sorgu) | string | Hayır | Ad/VKN/e-posta araması |
| include_archived (sorgu) | "true" | "false" | Hayır | Arşivlileri de getir |
Yanıt
200Liste (imleçli)
| Alan | Tür | Açıklama |
|---|---|---|
| data | Counterparty[] | |
| data[].id | string (uuid) | Sistem kimliği (UUID) |
| data[].external_id | string | null | ERP cari kodu |
| data[].name | string | Firma adı |
| data[].tax_number | string | null | VKN (10) / TCKN (11) |
| data[].email | string | null | Mutabakat muhatabı e-postası |
| data[].contact_name | string | null | |
| data[].notes | string | null | |
| data[].archived_at | string | null (date-time) | Arşivlenmişse tarih |
| data[].created_at | string | null (date-time) | |
| data[].updated_at | string | null (date-time) | İmleçli listelerde sıralama anahtarı |
| 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/counterparties \
-H "Authorization: Bearer $MAI_API_KEY"