Paginated list of monthly invoices
Monthly settlements issued to your account, newest first. DRAFT settlements (under Safariat review) are never returned. See Settlements & reconciliation for the money model.
Authorizations
API key authentication. Issued by the Safariat admin or via the partner portal. The secret is shown only once at generation.
Production sk_live_* keys must additionally sign every write request
(POST/PUT/DELETE) with the X-Timestamp and X-Signature headers.
Sandbox sk_test_* keys are exempt from request signing: X-Signature and
X-Timestamp are not required for writes in the sandbox (so the developer-portal
"Try it" playground works end to end). The Idempotency-Key header remains
required on writes in both environments.
Query Parameters
DRAFT: generated, under Safariat admin review, not visible to the bank.ISSUED: issued, PDF invoice available, payment expected.PAID: transfer received, marked by a Safariat admin.OVERDUE: past the due date without payment.DISPUTED: the bank disputes it, blocking future issuances.CANCELLED: administrative cancellation (exception).
DRAFT, ISSUED, PAID, OVERDUE, DISPUTED, CANCELLED Opaque pagination cursor returned by the previous response in meta.next_cursor.
Pass null/omit on the first request; absence of next_cursor in the response
signals the last page. Treat the cursor as fully opaque — its format is internal
and may evolve.
Keyset pagination (all listing endpoints except /adventures). The cursor
is anchored on the last row of the previous page, so results are stable under
concurrent writes — no duplicates, no skipped rows when items are inserted
between page fetches. Two cursors are not interchangeable across endpoints:
a cursor obtained from /reviews will be rejected with 400 on /bookings.
/adventures is offset-based by design (dynamic sort: popularity, price,
distance) and will not migrate to keyset. Its cursor cannot be passed to other
endpoints.
Behavior change (Phase B): /webhooks/deliveries now sorts by created_at
instead of updated_at. The previous sort field is mutable (retry attempts),
which is incompatible with the keyset invariant. Use the status filter to
surface deliveries currently being retried (status=PENDING,FAILED).
256Maximum number of items per page.
1 <= x <= 100