Create Dispute Counter

Start composing your evidence response to a dispute by creating a draft "counter". A counter holds your categorized evidence (each item is a canonical evidence category plus free text and/or attached files) for one round of a dispute, and is continuously saved as a draft so you don't lose work before submitting. There is **at most one open draft per dispute round**. Calling this when a draft already exists returns that draft rather than creating a duplicate, so it's safe to call on page load. Any attached `file_ids` must reference files you uploaded via the Files API; referencing a file you don't own returns `422`.

Authentication

x-truemed-api-keystring

Sales channel API key for merchant server-to-server authentication

Path parameters

business_idstringRequired

The Truemed dispute ID (UUID).

Request

Request body for CounterCreateRequest
evidence_itemslist of objectsOptionalDefaults to []
Initial categorized evidence for the draft.

Response

Successful response
counter_idstring

Stable Truemed counter ID (UUID).

created_atdatetime
When this counter was created.
phaseenum
Dispute phase this counter responds to.
revisioninteger

Optimistic-lock revision; echo it back on the next draft save to detect conflicts.

stateenum
Counter lifecycle state.
updated_atdatetime
When this counter was last updated.
evidence_itemslist of objectsDefaults to []
The categorized evidence captured on this counter.
submitted_atdatetime or null
When this counter was submitted to the processor.
submitted_bystring or null

Email of the dashboard user who submitted this counter; null for drafts or API-key submissions.

Errors

400
Bad Request Error
404
Not Found Error
405
Method Not Allowed Error
500
Internal Server Error
501
Not Implemented Error