Conventions

Dates#

All dates are UTC in ISO 8601: 2026-11-05T09:30:00Z.

Ids#

Ids are opaque strings of 12 characters. Do not parse them.

Pagination#

limit sets the page size. When more rows exist, meta.next_cursor has a value: send it as cursor.

Repeat protection#

Send Idempotency-Key with 8 to 128 letters, digits, - or _. The result is kept for 24 hours. The same key with a different body returns 409 idempotency_mismatch. It is required for tool runs and optional for writes.

Language#

Set Accept-Language to en, tr or pt for error messages.

Response headers#

Every response has X-Request-Id. MessGEO-Account-Notice: payment_past_due appears while a payment is overdue.