---
title: "Submit dispute evidence"
method: POST
path: "/disputes/{caseReference}/evidence"
---

# Submit dispute evidence

`POST /disputes/{caseReference}/evidence`

Atomically submits previously uploaded files as evidence for the dispute. The path is the only source of caseReference. Retries using the same path, nonce, and exact request body return the original 201 response. After a 500, retry with the same nonce; do not rotate it.

## Path parameters

- `caseReference` string, required

## Request body

- object
  - `nonce` string, required
  - `fileIds` string[], required
  - `submittedBy` string
  - `comments` string

## Response `201`

Evidence received, including an exact idempotent replay.

- union — Successful evidence submission receipt. `status` discriminates the wire shape. `received` is the current Chargeback-Dash receipt. `pending` is the webhook-aligned body that repeats `transactions[]` and nests the submission under `evidenceSubmission`.
  - object
    - `caseReference` string, required
    - `status` 'received', required
    - `submittedAt` string, date-time, required
    - `submittedBy` string
    - `comments` string
    - `files` object[], required
      - `fileId` string, required
      - `filename` string, required
      - `evidenceType` 'consolidated', required
  - object
    - `caseReference` string, required
    - `status` 'pending', required — Case status. Matches `dispute.evidence_received`.
    - `evidenceDueAt` string, date-time, required
    - `transactions` object[], required
      - `id` string, nullable, required
      - `createdAt` string, date-time, nullable, required
      - `amount` object, required
        - `currency` string, required
        - `amount` number, required
      - `scheme` string, nullable, required
      - `acquirer` string, required
      - `reasonCode` string, required
      - `reasonDescription` string, nullable, required
      - `authorizationCode` string, required
      - `retrievalReferenceNumber` string, required
      - `acquirerReferenceNumber` string, required
      - `externalReference` string, nullable, required
      - `eci` string, nullable, required
      - `secure3dVersion` string, nullable, required
      - `liabilityShift` string, required
      - `secure3dDecision` string, nullable, required
      - `secure3dDecisionReason` string, nullable, required
    - `evidenceSubmission` object, required
      - `submittedAt` string, date-time, required
      - `submittedBy` string, nullable, required
      - `comments` string
      - `files` object[], required
        - `fileId` string, required
        - `filename` string, required
        - `evidenceType` string, required

## Other responses

- `400` — Malformed fields or invalid file IDs. Parser-level failures, including malformed JSON, return text/plain.
- `401` — Missing, expired, or invalid access token.
- `403` — The token lacks the client_evidence_submission scope.
- `404` — The case is missing or not owned by the authenticated client.
- `409` — Idempotency conflict, or a concurrent identical submission still in progress. Sequential retries of the same nonce wait for a terminal 201 or 500 rather than poll this status.
- `410` — The evidence deadline has passed.
- `422` — The case cannot accept evidence in its current state.
- `500` — Unexpected server failure; retry with the same nonce.

## Changes

- **2026-08-21** `6882c8d02fd7` — 6 breaking, 2 warning, 2 info
  - added `subschema #1, subschema #2` to the response body `oneOf` list for the response status `201`
  - the response's body type/format changed from `object`/`` to ``/`` for status `201`
  - removed the required property `caseReference` from the response with the `201` status
  - removed the required property `files` from the response with the `201` status
  - …6 more
- **2026-07-26** `c49212f8f795` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stitch/apis/stitch-api/changes/disputes/:caseReference/evidence/post.md)

---

[API](https://skmtc.dev/stitch/apis/stitch-api.md) · [All operations](https://skmtc.dev/stitch/apis/stitch-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stitch/stitch-api/revisions/8c5a258567d0/schema)