> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teel.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Payout

> Get a payout by ID

<Info>**Scope** `payouts:read`</Info>

## Headers

<ParamField header="Authorization" type="string" required>
  API key.
</ParamField>

## Path parameters

<ParamField path="id" type="string" required>
  Payout `transactionId` from [`POST /rfq/execute`](/api-reference/payouts/execute).
</ParamField>

## Response

<ResponseField name="id" type="string">
  Payout ID.
</ResponseField>

<ResponseField name="transactionType" type="string">
  `payout` or `swap`.
</ResponseField>

<ResponseField name="status" type="string">
  `pending`, `processing`, `completed`, `failed`, or `cancelled`. See [Core Concepts](/concepts#transaction-status) for the lifecycle.
</ResponseField>

<ResponseField name="sourceAmount" type="number">
  Amount debited.
</ResponseField>

<ResponseField name="sourceCurrency" type="string">
  ISO 4217 code.
</ResponseField>

<ResponseField name="payoutAmount" type="number">
  Amount credited to the recipient.
</ResponseField>

<ResponseField name="payoutCurrency" type="string">
  ISO 4217 code.
</ResponseField>

<ResponseField name="recipientId" type="string">
  Recipient ID.
</ResponseField>

<ResponseField name="paymentMethod" type="string">
  Funding method.
</ResponseField>

<ResponseField name="paymentPurpose" type="string">
  Stated purpose.
</ResponseField>

<ResponseField name="reference" type="string">
  Free-text reference you set at execution time.
</ResponseField>

<ResponseField name="providerMetadata" type="object">
  Routing detail for the executed payout.

  <Expandable title="providerMetadata">
    <ResponseField name="version" type="integer">
      Schema version.
    </ResponseField>

    <ResponseField name="onramp" type="object">
      Onramp leg detail. Present on fiat-to-stablecoin and fiat-to-fiat payouts.
    </ResponseField>

    <ResponseField name="offramp" type="object">
      Offramp leg detail. Present on stablecoin-to-fiat and fiat-to-fiat payouts.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp.
</ResponseField>

<ResponseField name="completedAt" type="string">
  ISO 8601 timestamp. Present when `status` is `completed`.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "pay_abc123",
    "transactionType": "payout",
    "status": "completed",
    "sourceAmount": 1000.00,
    "sourceCurrency": "USD",
    "payoutAmount": 4425.00,
    "payoutCurrency": "MYR",
    "recipientId": "rec_xyz",
    "paymentMethod": "fiat_bank_transfer",
    "paymentPurpose": "trade_settlement",
    "providerMetadata": {
      "version": 1,
      "onramp": { "protocol": "provider_a", "status": "completed" },
      "offramp": { "protocol": "provider_a", "amount": 4425, "currency": "MYR" }
    },
    "createdAt": "2026-03-01T10:00:00Z",
    "completedAt": "2026-03-01T10:05:00Z"
  }
  ```
</ResponseExample>