disputes

Create a draft evidence counter for a dispute

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.

post/api/v1/disputes/{business_id}/counters

Request

  • Base URL: https://dev-api.truemed.com
  • URL: https://dev-api.truemed.com/api/v1/disputes/{business_id}/counters
  • Auth: API key in header x-truemed-api-key

Path parameters

business_idstring required

The Truemed dispute ID (UUID).

Request body

Response

Successful response

counter_idstring required

Stable Truemed counter ID (UUID).

created_atstring date-time required

When this counter was created.

phase'inquiry' | 'dispute' | 'pre_arbitration' | 'arbitration' required

Which round of a dispute this is — orthogonal to DisputeState (comparison doc §4.3/§5).

revisioninteger required

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

state'draft' | 'submitted' | 'withdrawn' | 'superseded' required

Lifecycle of a dispute-evidence response (a "counter").

draft autosaves; submitted is terminal-for-this-round (one-shot to the processor); withdrawn is a discarded draft; superseded is a prior round's submission once a new phase opens. Only draft is mutable.

submitted_atstring date-time nullable

When this counter was submitted to the processor.

submitted_bystring nullable

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

updated_atstring date-time required

When this counter was last updated.

Changes

No recorded changes to this operation across all 1 revision of this API.