Errors and pagination

Errors

Failed requests return:

{
  "error": {
    "code": "validation_error",
    "message": "Human-readable explanation.",
    "request_id": "optional-correlation-id"
  }
}

Common codes: validation_error, not_found, external_reference_exists, idempotency_conflict, internal_error.

Include X-Request-Id / request_id when contacting Dimmi support.

Pagination

List endpoints use cursor pagination:

Query	Meaning
cursor	Opaque cursor from the previous page
page_size	Page size (max 100)

Responses follow DRF cursor style (next / previous links and results). Always follow next rather than inventing offsets.

Opaque IDs

Public resources use prefixed ids such as case_…, person_…, perm_…, cert_…, asgn_…, doc_…. Do not assume these are raw database UUIDs.