Read civic complaints

Available read operations

• GET /api/v1/complaints lists account complaints with complaints:read.
• GET /api/v1/complaints/{complaintReference} returns one account-scoped detail with complaints:read.
• GET /api/v1/complaints/{complaintReference}/attachments/primary returns validated private evidence with complaints:attachments:read.
• References match CMP-YYYY-XXXXXXXXXXXXXXXX. Unknown, cross-account, erased, or inaccessible complaints and evidence use uniform not-found behavior and never reveal internal UUIDs.

List contract

• limit is 1 through 100 and defaults to 50.
• before is the prior page nextCursor, which is another public complaint reference rather than an internal UUID.
• status can be submitted, acknowledged, in_review, assigned, in_progress, resolved, rejected, or closed.
• Items include reference, taxonomy codes, status, priority, assignment identifiers, lead status, version, erasure state, and timestamps.

Detail and privacy

• Detail can contain citizen-provided location and description data. Treat it as sensitive and minimize logging, caching, analytics, and support copies.
• Responses omit complaint UUID, attachment UUID, contact and phone-identity UUIDs, conversation UUID, storage key, content hash, and account ID.
• Attachment metadata is descriptive only: MIME type, byte size, and retention state do not grant access to image bytes.
• All complaint responses use private, no-store caching policy.

List example

curl "/api/v1/complaints?status=submitted&limit=25"   -H "Authorization: Bearer tus_live_your_key_here"