Get transaction recovery status

See the Mode 3 recovery state and refund timeline for a transaction.

Sandbox APIhttps://sandbox-api.nuvante.io

Returns recoveryState, the amounts involved, and a timeline for transactions where tokens were transferred but not burned. Every Mode 3 integration has to provide this visibility.

Parameters

Get transaction recovery status parameters
Field	Type	Required	Description
Authorization	string · header	Yes	Bearer sandbox API key with `transactions:read`.
id	string (UUID) · path	Yes	Transaction ID.

Responses

200Recovery state and timeline.

Create a sandbox API key

Request

curl --request GET \
  --url 'https://sandbox-api.nuvante.io/api/v1/transactions/123e4567-e89b-42d3-a456-426614174000/recovery-status' \
  --header 'Authorization: Bearer nvt_sandbox_your_key' \
  --header 'Accept: application/json'

Response

{
  "data": {
    "transactionId": "e7a1c3f5-9b2d-4e6f-8a0c-2b4d6f8a1c3e",
    "recoveryState": "refund_confirmed",
    "preBurnTransferAmount": "100100.00",
    "refundedAmount": "100100.00",
    "timeline": [
      {
        "state": "transferred_awaiting_instruction",
        "at": "2026-09-01T09:58:00.000Z"
      },
      {
        "state": "instruction_expired",
        "at": "2026-09-01T10:03:00.000Z"
      },
      {
        "state": "refund_requested",
        "at": "2026-09-01T10:03:05.000Z"
      },
      {
        "state": "refund_confirmed",
        "at": "2026-09-01T10:04:12.000Z"
      }
    ]
  },
  "meta": {
    "commandId": "723e4567-e89b-42d3-a456-426614174023"
  }
}