Get a transaction

Fetch one transaction, including its saga state and available actions.

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

Poll this endpoint after you initiate a transaction. Settlement only moves forward after proof-backed issuer events, so please wait for those and treat an issuer's intermediate authorisation as progress only.

Parameters

Get a transaction parameters
Field	Type	Required	Description
Authorization	string · header	Yes	Bearer sandbox API key with `transactions:read` or `transactions:write`.
id	uuid · path	Yes	The transaction ID you got back when you initiated it.

Responses

200Full transaction envelope.

404Transaction unknown or outside your scope.

Try this request in the sandbox console

Request

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

Response

{
  "data": {
    "actions": {
      "cancel": {
        "allowed": true
      },
      "override": {
        "cancel": {
          "allowed": false
        },
        "settle": {
          "allowed": false
        }
      }
    },
    "details": {
      "chain": "Locked",
      "rtgs": "Earmarked",
      "sagaStep": {
        "current": 5,
        "name": "Burning",
        "total": 6
      }
    },
    "id": "123e4567-e89b-42d3-a456-426614174000",
    "initiatedAt": "2026-07-30T14:00:00.000Z",
    "lifecycleStatus": "in-flight",
    "parked": false,
    "paymentReference": "DVP-REDEEM-0001",
    "saga": {
      "currentStepIndex": 4,
      "steps": [
        {
          "name": "Received",
          "status": "done"
        },
        {
          "name": "Validated",
          "status": "done"
        },
        {
          "name": "Lock",
          "status": "done"
        },
        {
          "name": "Earmarked",
          "status": "done"
        },
        {
          "name": "Burning",
          "status": "current"
        },
        {
          "name": "Settled",
          "status": "pending"
        }
      ]
    },
    "source": {
      "amount": {
        "amount": "250000.00",
        "asset": {
          "code": "GBPC",
          "issuer": "GA7QYNF7SOWQ3GLR2BGMZEHXAVIRZA4KVWLTJJFC7MGXUA74P7UJUWDA"
        }
      },
      "party": {
        "participantId": "223e4567-e89b-42d3-a456-426614174001",
        "participantKind": "clearing_member",
        "participantName": "Example Bank"
      }
    },
    "target": {
      "amount": {
        "amount": "250000.00",
        "asset": {
          "code": "GBP"
        }
      },
      "party": {
        "participantId": "323e4567-e89b-42d3-a456-426614174002",
        "participantKind": "stablecoin_issuer",
        "participantName": "GBPC Issuer"
      }
    },
    "terminal": false,
    "updatedAt": "2026-07-30T14:00:03.000Z"
  },
  "meta": {
    "commandId": "523e4567-e89b-42d3-a456-426614174004"
  }
}