---
title: "Returns the transaction response of a non-pending transaction"
method: GET
path: "/transactions/{shinkansen_id}/response"
tags: ["Transactions & Responses"]
---

# Returns the transaction response of a non-pending transaction

`GET /transactions/{shinkansen_id}/response`

## Request

- Base URL: `https://api.shinkansen.finance/v1`
- URL: `https://api.shinkansen.finance/v1/transactions/{shinkansen_id}/response`
- Auth: API key in header `Shinkansen-Api-Key`

Can be used when the participant needs to re-check the response for a given transaction (e.g: if an unexpected error means they lost a response)

## Response `200`

The response of a non-pending transaction.

- TransactionResponse
  - `transaction_type` string, required: Transaction type. Always should be `"payout"` for this type of transaction.
  - `transaction_id` string, required: UUID Unique identifier of the transaction. Generated by original sender of the payout.
  - `shinkansen_transaction_id` string, required: UUID Unique identifier of the transaction. Set by Shinkansen on the transaction message.
  - `response_id` string, uuid, required: UUID Unique identifier of the transaction *response*. Set by the payout operator.
  - `response_status` 'ok' | 'invalid' | 'error_creditor_account_not_found' | 'error_creditor_account_detail_mismatch' | 'error_creditor_account_over_limits' | 'error_creditor_account_closed' | 'error_creditor_account_currency_mismatch' | 'error_creditor_reject' | 'error_creditor_fi_offline' | 'error_payment_rail_offline' | 'error_debtor_account_not_found' | 'error_debtor_account_detail_mismatch' | 'error_debtor_account_over_limits' | 'error_debtor_insufficient_funds' | 'error_debtor_reject' | 'error_debtor_fi_offline' | 'error_delivery_ttl_expired' | 'error_expired' | 'error', required: Status as reported by the payout operator (or Shinkansen if the operator is down): * `ok`: The payout was successful. * `invalid`: The request failed some validation * `error_creditor_account_not_found`: The destination account doesn't exist * `error_creditor_account_detail_mismatch`: Something is wrong with the destination account details * `error_creditor_account_over_limits`: The destination account is over the limits set by the creditor bank/institution * `error_creditor_account_closed`: The destination account is closed, cancelled or blocked * `error_creditor_account_currency_mismatch`: The payout currency doesn't match the currency of the destination account * `error_creditor_reject`: The payout was returned or rejected by the creditor bank/institution * `error_creditor_fi_offline`: The creditor bank/institution is temporarily offline * `error_payment_rail_offline`: The payment rail used by Shinkansen/PO is temporarily offline * `error_debtor_account_not_found`: The origin account doesn't exist * `error_debtor_account_detail_mismatch`: Something is wrong with the origin account details * `error_debtor_account_over_limits`: The origin account is over the limits set by the debtor bank/institution or the payout operator. * `error_debtor_insufficient_funds`: The origin account doesn't have enough funds to cover the payout amount. * `error_debtor_reject`: The debtor bank/institution rejected the debit * `error_debtor_fi_offline`: The debtor bank/institution is temporarily offline * `error_delivery_ttl_expired`: The transaction could not be delivered to the source bank/institution before the TTL specified on the original payout message. * `error_expired`: The payout expired at the bank/institution before it could be processed (for example, a cut-off time or an acceptance window was exceeded) * `error`: Other errors not categorized above
  - `response_message` string, required: Human-readable message further explaining the status.
  - `shinkansen_transaction_status` 'ok' | 'error', required: Status as reported by Shinkansen. Either `ok` or `error` (Can't be `pending` because that's the status for transactions without a response)
  - `shinkansen_transaction_message` string, required: Human-readable message further explaining the Shinkansen status.

## Other responses

- `403`: Forbidden (e.g: wrong API Key)
- `404`: Transaction id not found or response not found (transaction is pending).

## Changes

- **2026-11-03** `f42261dee5a6`: 7 breaking, 1 warning, 1 info
  - removed the required property `response_message` from the response with the `200` status
  - removed the required property `response_status` from the response with the `200` status
  - removed the required property `shinkansen_response_id` from the response with the `200` status
  - removed the required property `shinkansen_transaction_id` from the response with the `200` status
  - …5 more

[Operation history](https://skmtc.dev/shinkansen/apis/payouts-shinkansen-endpoints/changes/transactions/:shinkansen_id/response/get.md)

---

[API](https://skmtc.dev/shinkansen/apis/payouts-shinkansen-endpoints.md) - [All operations](https://skmtc.dev/shinkansen/apis/payouts-shinkansen-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/shinkansen/apis/payouts-shinkansen-endpoints/revisions/f42261dee5a6?raw)