Ekstre Karşılaştırma

İş Listeleme(listJobs)

GET/statement-jobs

İşleri listele

Son güncelleme: 21 Eylül 2026 · Sözleşme sürümü 1.0.0

İmleçli liste. status=awaiting_counterparty karşı taraf dosyası bekleyen işleri verir.

Servis

Metot	GET
Adres	https://mutabakat.ai/api/v1/statement-jobs
Kapsam	`statements:read`
Idempotency-Key	Kullanılmaz
dry_run	Yok

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" \| "files_uploaded" \| "parsing" \| "queued" \| "matching" \| "snapshotting" \| "completed" \| "failed" \| "awaiting_counterparty"	Hayır	İş durumu (türetilmiş `awaiting_counterparty` dâhil)
external_id (sorgu)	string	Hayır	ERP belge numarası

200Liste (imleçli)

Alan	Tür	Açıklama
data	Job[]
data[].id	string (uuid)
data[].external_id	string \| null
data[].title	string
data[].status	"draft" \| "files_uploaded" \| "parsing" \| "queued" \| "matching" \| "snapshotting" \| "completed" \| "failed" \| "awaiting_counterparty"	`awaiting_counterparty`: bizim dosya yüklü, karşı taraf dosyası yok.
data[].progress	integer \| null	Kaba yüzde (draft 0 · files_uploaded 10 · parsing 25 · queued 40 · matching 60 · snapshotting 90 · completed 100); failed → null
data[].currency	string
data[].sides	object
data[].sides.ours	JobSide
data[].sides.theirs	JobSide
data[].results_available	boolean
data[].error	string \| null	`failed` durumunda neden
data[].blocked_reason	"plan_limit_reached" \| "active_match_limit_reached" \| null	İki dosya da ayrıştı ama eşleştirme kota/aktif yuva nedeniyle park edildi; muhasebe personeli panelden başlatır.
data[].period_start	string \| null
data[].period_end	string \| null
data[].created_at	string \| null (date-time)
data[].started_at	string \| null (date-time)
data[].completed_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

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.

curl -X GET https://mutabakat.ai/api/v1/statement-jobs \
  -H "Authorization: Bearer $MAI_API_KEY"