> ## 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 status

> Current status of a payout, by quote ID.

Lookup by `quoteId` from [`POST /rfq/execute`](/api-reference/payouts/execute). Prefer [Webhooks](/guides/webhooks) over polling.

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

## Headers

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

## Path parameters

<ParamField path="quoteId" type="string" required>UUID of the locked quote.</ParamField>

## Response

Fields are populated progressively. Pre-settle reads show core + escrow detail; post-settle reads add the actual amounts and `transactionId`.

<Tabs>
  <Tab title="Common">
    <ResponseField name="quoteId" type="string">Echoed back.</ResponseField>
    <ResponseField name="status" type="string">Coarse-grained status. See [Core Concepts](/concepts#transaction-status).</ResponseField>
    <ResponseField name="transactionId" type="string">UUID of the underlying payout — use with [`GET /payouts/{id}`](/api-reference/payouts/get). Populated once written.</ResponseField>
    <ResponseField name="quotedToAmount" type="number">Destination amount as quoted at lock time.</ResponseField>
    <ResponseField name="actualToAmount" type="number">Destination amount that actually settled. Post-delivery.</ResponseField>
    <ResponseField name="deltaAmount" type="number">Signed `actualToAmount − quotedToAmount`. Surfaces FX slippage.</ResponseField>
    <ResponseField name="settleTxHash" type="string">On-chain settlement tx hash (S2F / fiat-to-stablecoin).</ResponseField>
    <ResponseField name="onrampProvider" type="string">Opaque routing identifier of the onramp leg.</ResponseField>
    <ResponseField name="offrampProvider" type="string">Opaque routing identifier of the offramp leg.</ResponseField>
    <ResponseField name="paymentUrl" type="string">Hosted payment page (onramp flows).</ResponseField>
    <ResponseField name="bankingInstructions" type="object">Map of `string` → `string` for bank-transfer settlement.</ResponseField>
    <ResponseField name="errorMessage" type="string">Set when `status` is `failed`.</ResponseField>
  </Tab>

  <Tab title="Stablecoin-to-fiat">
    Same `Common` fields plus the escrow detail below.

    <ResponseField name="escrowAddress" type="string">On-chain address your wallet sent (or must send) the stablecoin to.</ResponseField>
    <ResponseField name="depositAmountAtomic" type="string">Atomic-units integer string. Parse with `BigInt`.</ResponseField>
    <ResponseField name="tokenAddress" type="string">ERC-20 contract of the source stablecoin.</ResponseField>
    <ResponseField name="chainId" type="integer">Chain id of the source token.</ResponseField>
    <ResponseField name="escrowChainId" type="integer">Chain on which the escrow slot lives.</ResponseField>
    <ResponseField name="escrowState" type="string">One of `none` (no escrow yet), `active` (deposit pending or in flight), `settled` (post-settle), `cancelled` (explicitly cancelled). Don't branch on other values — none are emitted.</ResponseField>
    <ResponseField name="actualUsdcReceived" type="string">Atomic-units integer string of USDC the escrow received (e.g. `"227250000"` for 227.25 USDC at 6 decimals). Parse with `BigInt`. `"0"` until deposit confirmation.</ResponseField>
  </Tab>
</Tabs>

<ResponseExample>
  ```json 200 — Pre-settle (S2F) theme={null}
  {
    "success": true,
    "data": {
      "quoteId": "4c2b7e8f-3a3c-4a08-94ad-1234567890ab",
      "status": "awaiting_escrow_deposit",
      "quotedToAmount": 4425.00,
      "escrowAddress": "0xAbcDef0123456789AbcDef0123456789AbcDef01",
      "depositAmountAtomic": "227250000",
      "tokenAddress": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
      "chainId": 137,
      "escrowState": "active"
    }
  }
  ```

  ```json 200 — Post-settle theme={null}
  {
    "success": true,
    "data": {
      "quoteId": "4c2b7e8f-3a3c-4a08-94ad-1234567890ab",
      "status": "delivered",
      "transactionId": "8b1a4c1d-7a3c-4a08-94ad-9f1ef1e0c3a2",
      "quotedToAmount": 4425.00,
      "actualToAmount": 4423.50,
      "deltaAmount": -1.50,
      "settleTxHash": "0x1234abcd…",
      "onrampProvider": "provider_a",
      "offrampProvider": "provider_a",
      "escrowState": "settled",
      "actualUsdcReceived": "227250000"
    }
  }
  ```
</ResponseExample>