Skip to content

List evidence

Lists the evidence recorded on a transaction, from oldest to newest.

Endpoint

GET https://api.rapidchargeback.com/api/v1/evidence?transaction_id=<uuid>

Authentication

Basic Auth with client_id:client_secret. See Authentication.

Query params

Param	Type	Description	Required
`transaction_id`	string (UUID)	Transaction whose evidence you want to see	Yes

Unlike the POST, there is no lookup by transaction_ref here: the query is by Rapid’s UUID only.

Validations

Rule	Response
`transaction_id` missing	`422 VALIDATION_ERROR`: transaction_id is required
Missing or invalid credential	`401 UNAUTHORIZED`

A transaction from another company, or a nonexistent one, returns an empty list, because the query is filtered by your company; it does not return an error.

Request example

curl "https://api.rapidchargeback.com/api/v1/evidence?transaction_id=00000000-0000-0000-0000-000000000042" \
  -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="

Response examples

Success (200)

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-0000000000e1",
      "type": "terms_acceptance",
      "payload": {
        "ip": "203.0.113.10",
        "accepted_at": "2026-04-01T15:29:40Z",
        "terms_version": "v3.2"
      },
      "captured_at": "2026-04-01T15:29:41.000Z",
      "created_at": "2026-04-01T15:32:36.027Z"
    }
  ]
}

Field	Description
`id`	Evidence ID
`type`	The type given in the record
`payload`	The object you sent, as you sent it. Key order is not preserved
`captured_at`	When the fact happened, as you reported it
`created_at`	When Rapid received the record

No evidence (200)

{ "data": [] }

Error: missing `transaction_id` (422)

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "transaction_id is required"
  }
}

Next steps