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

# Get Payout Details

> Retrieve real-time status and settlement details for an individual payout.

Fetches the complete details and execution breakdown of a single payout by its transaction UUID.

### Scopes required

`payouts:read` or `*`

### Path parameters

<ParamField path="id" type="string" required>
  The unique transaction identifier (e.g. `7d9c0245-31ba-4f27-a0c3-fba4313f89e2`).
</ParamField>

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer API secret key formatted as `Bearer sk_live_...` or `Bearer sk_test_...`.
</ParamField>

### Response

<ResponseField name="id" type="string">
  Unique transaction identifier.
</ResponseField>

<ResponseField name="reference" type="string">
  Payout reference code.
</ResponseField>

<ResponseField name="type" type="string">
  Transaction type (`PAYOUT`).
</ResponseField>

<ResponseField name="status" type="string">
  Status: `PROCESSING`, `PENDING`, `SUCCESS`, or `FAILED`.
</ResponseField>

<ResponseField name="currency" type="string">
  Currency code.
</ResponseField>

<ResponseField name="amountMinor" type="string">
  Amount in minor units as string.
</ResponseField>

<ResponseField name="ngnAmountMinor" type="string">
  Total NGN debit in minor units.
</ResponseField>

<ResponseField name="recipient" type="string">
  Beneficiary full legal name.
</ResponseField>

<ResponseField name="metadata" type="object">
  Integration metadata.
</ResponseField>

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

<ResponseField name="completedAt" type="string">
  Settlement completion timestamp, or null if pending.
</ResponseField>

<ResponseField name="payout" type="object">
  Detailed payout record.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.tabsglobal.co/v1/payouts/7d9c0245-31ba-4f27-a0c3-fba4313f89e2" \
    -H "Authorization: Bearer sk_live_..."
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.tabsglobal.co/v1/payouts/7d9c0245-31ba-4f27-a0c3-fba4313f89e2",
    {
      method: "GET",
      headers: {
        "Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
      },
    }
  );

  const payout = await response.json();
  console.log(payout);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.tabsglobal.co/v1/payouts/7d9c0245-31ba-4f27-a0c3-fba4313f89e2",
      headers={"Authorization": f"Bearer {API_KEY}"},
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "7d9c0245-31ba-4f27-a0c3-fba4313f89e2",
    "reference": "PO-AB12CD34",
    "type": "PAYOUT",
    "status": "SUCCESS",
    "currency": "NGN",
    "amountMinor": "2500000",
    "ngnAmountMinor": "2500000",
    "recipient": "ADEWALE ADELEKE",
    "metadata": {
      "railReference": "NIP-9948102941",
      "provider": "embedly"
    },
    "createdAt": "2026-09-21T02:00:00.000Z",
    "completedAt": "2026-09-21T02:00:15.000Z",
    "payout": {
      "rate": 1,
      "transferFeeMinor": "0",
      "totalDebitMinor": "2500000",
      "recipientAddress": null,
      "bank": null,
      "accountNumber": "0123456789",
      "routing": null,
      "sortCode": null,
      "iban": null,
      "bic": null,
      "narration": "Invoice settlement #1042",
      "eta": "Instant",
      "railReference": "NIP-9948102941"
    }
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.