Get a transfer status
Returns the current state of an outbound transfer and its full reversal history as stored in the Gateway. This endpoint queries gateway state only; it does not send a live consult to the switch network.
Use it when the participant needs to confirm transfer and reversal outcomes
(for example after a webhook timeout or during SAF retries). The root-level
reversed boolean indicates whether the transfer was effectively reversed;
reversals lists every reversal attempt with its own status and CCA response.
Path Parameters
- Type: stringFormat: uuidshinkansen
_id requiredUUID v4 identifying the transfer. The gateway resolves it in this order:
- Shinkansen internal transaction ID (
shinkansen_transaction_idfrom the transfer ACK). - Participant transaction ID (
transaction_idfrom the original transfer request).
- Shinkansen internal transaction ID (
Responses
- application/json
- application/json
- application/json
- application/json
Request Example for get/transfers/{shinkansen_id} /status
curl https://sandbox-gateway.shinkansen.finance/api/transfers/123e4567-e89b-12d3-a456-426614174000/status \
--header 'Shinkansen-Api-Key: YOUR_SECRET_TOKEN'
{
"transaction_id": "957448bf-2d65-4384-a0cd-2a3fbadedd93",
"shinkansen_transaction_id": "bddc94cb-506a-4dad-a3e1-be52e3454ec6",
"status": "ok",
"response_status": "approved",
"amount": "70000",
"currency": "CLP",
"reference": "Shinkansen Test",
"tracenumber": 293,
"switch_timestamp": "2026-06-29T11:58:15",
"gateway_timestamp": "2026-06-29T15:58:15Z",
"reversed": true,
"reversals": [
{
"reversal_id": "ffb64ae1-bf39-4a66-8858-552f37176c44",
"shinkansen_reversal_id": "bacf2eba-7dfa-46e8-b7b1-8966681da8b2",
"reversal_type": "reversal_conditional",
"status": "ok",
"response_status": "approved",
"tracenumber": 293,
"received_at": "2026-06-29T15:58:29Z",
"switch_timestamp": "2026-06-29T11:58:29"
}
]
}