Authentication

Same as the rest of the Cajari API. Use your API Key as a Bearer token in the HTTP Authorization header. Every call is scoped to your account — cases from other accounts are never visible.

All identifiers are opaque IDs. List endpoints paginate with limit and cursor.

Example Request

curl https://api.cajari.com/v2/cases \
    -H "Authorization: Bearer <your_api_key_here>"
                

List cases

GET /v2/cases

Lists cases for your account. Defaults to open cases, most-recent reply first.

Example Request

curl "https://api.cajari.com/v2/cases?status=open&sort=last_reply_desc" \
    -H "Authorization: Bearer <your_api_key_here>"
                

Example Response

{
    "synced_at": "2026-10-08T17:02:11Z",
    "cases": [
        {
            "id": "22451523931",
            "merchant_marketplace_id": "a1b2c3d4",
            "status": "pending_amazon",
            "amazon_status": "PendingAmazonAction",
            "subject": "FBA19L555DM7 - Missing Items from Inbound",
            "asin": "B0XXXXXXXX",
            "asins": ["B0XXXXXXXX"],
            "shipment_id": "FBA19L555DM7",
            "category": "fba_inventory",
            "created_at": "2026-10-07T06:18:53Z",
            "last_reply_at": "2026-10-07T06:19:05Z",
            "escalated": false,
            "synced_at": "2026-10-08T17:02:11Z"
        }
    ],
    "next_cursor": "..."
}
                

status is a normalized value; amazon_status is Amazon's raw value. asin, shipment_id, and category are parsed from the case subject and thread (best-effort; null/other when nothing obvious is found). The list view omits the message thread — fetch a single case for that.

Get a case

GET /v2/cases/{id}

Returns a single case with its full correspondence thread.

Example Response

{
    "id": "22451523931",
    "merchant_marketplace_id": "a1b2c3d4",
    "status": "pending_amazon",
    "amazon_status": "PendingAmazonAction",
    "subject": "FBA19L555DM7 - Missing Items from Inbound",
    "asin": "B0XXXXXXXX",
    "asins": ["B0XXXXXXXX"],
    "shipment_id": "FBA19L555DM7",
    "category": "fba_inventory",
    "created_at": "2026-10-07T06:18:53Z",
    "last_reply_at": "2026-10-07T06:19:05Z",
    "escalated": false,
    "messages": [
        {
            "id": "...",
            "direction": "inbound",
            "author": "Amazon",
            "sent_at": "2026-10-07T06:19:05Z",
            "body": "...",
            "has_attachments": true,
            "attachments": [
                {
                    "file_name": "invoice-12345.pdf",
                    "content_type": "application/pdf",
                    "download_url": "/v2/cases/22451523931/attachments/0A1B2C3D"
                }
            ]
        }
    ],
    "synced_at": "2026-10-08T17:02:11Z"
}
                

Each message lists its attachments' file_name, content_type, and a download_url. We re-host attachments in our own storage (Amazon's URLs expire within minutes), so the link is stable. download_url is null until the file has been captured — we capture attachments for non-resolved cases.

GET a download_url (with your Bearer token) to stream the file back with its original content type.

Reply to a case

POST /v2/cases/{id}/replies

Adds a reply to an existing case. Send an Idempotency-Key header (or client_reference_id) so a retry returns the original submission instead of posting a second reply.

Example Request

curl https://api.cajari.com/v2/cases/22451523931/replies \
    -H "Authorization: Bearer <your_api_key_here>" \
    -H "Idempotency-Key: 9f1c-..." \
    -H "Content-Type: application/json" \
    -d '{"body": "Following up on the reimbursement."}'
                

Example Response (202 Accepted)

{
    "submission": {
        "id": "sub_01J...",
        "type": "reply",
        "case_id": "22451523931",
        "status": "received",
        "handling": null,
        "attempts": 0,
        "received_at": "2026-10-08T17:05:00Z",
        "last_attempt_at": null,
        "completed_at": null,
        "request": { "body": "Following up on the reimbursement." },
        "result": null,
        "error": null,
        "poll_url": "/v2/case_submissions/sub_01J..."
    }
}
                

Get a submission

GET /v2/case_submissions/{id}

The status tracker you poll after a write.

GET /v2/case_submissions lists your submissions, filterable by status, type, case_id, and created_since.

Example Response

{
    "submission": {
        "id": "sub_01J...",
        "type": "reply",
        "case_id": "22451523931",
        "status": "succeeded",
        "handling": "automatic",
        "attempts": 1,
        "received_at": "2026-10-08T17:05:00Z",
        "last_attempt_at": "2026-10-08T17:12:30Z",
        "completed_at": "2026-10-08T17:12:33Z",
        "request": { "body": "Following up on the reimbursement." },
        "result": {
            "case_id": "22451523931",
            "reply_id": "...",
            "message": "Reply posted to Amazon."
        },
        "error": null
    }
}