--- title: "Get a fiat payout" method: GET path: "/v2/payouts/{payout_id}" tags: ["Payouts"] --- # Get a fiat payout `GET /v2/payouts/{payout_id}` ## Request - Base URL: `https://openapi.infini.money` - URL: `https://openapi.infini.money/v2/payouts/{payout_id}` - Auth: API key in header `Authorization` - TypeScript: (a function with typed inputs; its response is checked against the schema) Returns the latest payout state for the authenticated organization. Requires `payout.read` permission. `processing` means execution is still in progress. `completed` means the payout completed successfully. A receiving bank can still reject and return a previously completed transfer; the original payout remains `completed`, while the optional `return` object describes the bank return and compensating refund. `failed` means the payout failed before successful bank completion. ## Path parameters - `payout_id` string, required ## Headers - `X-API-Key-ID` string, required - `X-API-Timestamp` string, required - `X-API-Nonce` string, required - `Digest` string, required - `Authorization` string, required ## Response `200` Current payout state - PayoutEnvelope - `code` 0, required: Business code. `0` means success. - `message` string, required: Response message. - `data` Payout, required - `payout_id` string, required: Infini fiat payout ID. - `client_reference_id` string, required: Merchant-provided payout reconciliation reference. - `quote_id` string, required: Quote used to create the payout. - `provider` 'sgb', required: Execution provider selected by Infini. - `status` 'processing' | 'completed' | 'failed', required: Current payout lifecycle state. A receiving-bank return does not change a completed payout's status; inspect the `return` object for the compensating refund. API payouts have no approval-pending state. - `payout_type` 'swift', required: Payout rail bound by the quote. - `source_currency` 'USD', required: Organization balance currency. - `destination_currency` 'USD', required: Currency delivered to the recipient. - `destination_country` string, required: Destination country as an ISO 3166-1 alpha-2 code. - `amount_mode` 'send' | 'receive', required: Side fixed by the accepted quote. - `fee_paid_by` 'PAYER' | 'BENEFICIARY', required: Party responsible for payout fees. `PAYER` means external deduction; `BENEFICIARY` means internal deduction. Persisted for statement reconciliation. - `sending_amount` string, required: Actual total source-balance debit. This is also the authoritative outgoing statement amount. - `receiving_amount` string, required: Amount delivered to the recipient. - `transfer_fee_amount` string, required: Infini service fee frozen by the quote. It excludes any bank or rail fee. - `bank_fee_amount` string, required: Banking fee for the selected bank and payout rail frozen by the quote. Rail examples include SWIFT, ACH, and wire. - `fee_rate_decimal` string, required: Decimal transfer-fee rate frozen by the quote. - `rate` string, required: Exchange rate frozen by the quote. - `billing` BillingBreakdown, required - `currency` 'USD', required: Currency used by all billing amounts. - `transfer_fee` string, required: Infini service fee for processing the payout. It does not include any bank or rail fee. - `fx_fee` string, required: Foreign-exchange fee. It is `0.00` for the current USD-to-USD route. - `rail_fee` string, required: Banking fee associated with the selected bank and payout rail. - `total_fee` string, required: Sum of all fee components in the billing breakdown. - `fee_lines` FeeLine[], required: Itemized fee components used for reconciliation. - `type` 'transfer_fee' | 'fx_fee' | 'rail_fee', required: Fee component type. - `amount` string, required: Fee component amount in `currency`. - `currency` 'USD', required: Fee component currency. - `rate` string, required: Decimal rate used for this fee line, or `1` for a fixed rail fee. - `destination` BankDestinationView, required - `type` 'bank_account', required: Destination type. - `account_holder_type` 'individual' | 'business', required: Legal type of the bank-account holder. - `account_holder_name` string, required: Full legal name registered on the bank account. - `bank_country` string, required: Bank country as an ISO 3166-1 alpha-2 code. - `bank_name` string, required: Receiving bank's legal name. - `account_number_masked` string, required: Masked account number. Raw account details are never returned. - `swift_code` string, required: Receiving bank SWIFT/BIC code. - `purpose_code` string, required: Business purpose supplied at creation. - `statement_reference` string, nullable, required: Recipient-facing reference when supported. - `bank_reference` string, nullable, required: Bank transfer reference when available. - `failure` Failure, nullable, required: Failure details when the payout could not be completed; otherwise null. - `code` string, required: Stable machine-readable payout failure code. - `message` string, required: Human-readable payout failure details. - `return` PayoutReturn, nullable, required: Compensating refund created after a receiving bank returns a completed payout; otherwise null. The original payout remains `completed`. - `status` 'refunded', required: Settlement state of the compensating refund. - `reason_code` 'recipient_bank_rejected', required: Stable machine-readable reason for the bank return. - `reason` string, required: Human-readable bank-return reason when supplied by the banking partner. - `returned_amount` string, required: Amount the banking partner reported as returned. - `refund_amount` string, required: Amount actually credited back to the organization's balance after retained fees. - `retained_fee` string, required: Original payout fee retained and not included in `refund_amount`. - `currency` 'USD', required: Currency of the return, refund, and retained-fee amounts. - `returned_at` integer, required: Time the compensating refund was recorded, as Unix seconds. - `is_duplicate` boolean, required: Whether this response was produced by an idempotent create retry. - `created_at` integer, required: Payout creation time as Unix seconds. - `updated_at` integer, required: Payout last-update time as Unix seconds. - `completed_at` integer, nullable, required: Time the banking partner reported payout completion, as Unix seconds. ## Other responses - `400`: Request syntax or field validation failed - `401`: Authentication failed: invalid/disabled credential, signature, timestamp, nonce or digest. - `403`: Authenticated credential lacks permission or the client IP is not allowed. - `404`: Resource was not found for the authenticated organization - `500`: An unexpected internal error occurred ## Changes - **2026-10-23** `25c3ff16936d`: 7 breaking, 1 warning - added the new required `header` request parameter `Digest` - added the new required `header` request parameter `X-API-Key-ID` - added the new required `header` request parameter `X-API-Nonce` - added the new required `header` request parameter `X-API-Timestamp` - …4 more - **2026-08-18** `44f2f91e720d`: 2 info - added the non-success response with the status `400` - added the non-success response with the status `500` - **2026-08-10** `d74e6f53461f`: 1 breaking, 2 info - removed the required property `allOf[subschema #2]/data/returned_at` from the response with the `200` status - removed the `returned` enum value from the `allOf[subschema #2]/data/status` response property for the response status `200` - added the required property `allOf[subschema #2]/data/return` to the response with the `200` status [Operation history](https://skmtc.dev/infini/apis/infini-fiat-payout-api/changes/v2/payouts/:payout_id/get.md) --- [API](https://skmtc.dev/infini/apis/infini-fiat-payout-api.md) - [All operations](https://skmtc.dev/infini/apis/infini-fiat-payout-api/llms.txt) - [OpenAPI document](https://skmtc.dev/infini/apis/infini-fiat-payout-api/revisions/25c3ff16936d?raw)