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

# Verify the status of a payout

> Queries the status of a payout (wallet or mobile money) from the token returned at creation.

## Headers

<ParamField header="Apikey" type="string" required>
  API key of the LigdiCash project.
</ParamField>

<ParamField header="Authorization" type="string" required>
  `Bearer {API_TOKEN}`
</ParamField>

## Query parameter

<ParamField query="withdrawalToken" type="string" required>
  Token returned by the payout creation endpoint (`/withdrawal/create` or `/straight/payout`).
</ParamField>

## Response

<ResponseField name="response_code" type="string">`"00"` = call succeeded, any other value = error.</ResponseField>
<ResponseField name="token" type="string">JWT payout token — identical to the one passed as parameter.</ResponseField>
<ResponseField name="response_text" type="string">Result code label. Can be empty.</ResponseField>
<ResponseField name="description" type="string">Additional description. Can be empty.</ResponseField>
<ResponseField name="custom_data" type="array">Always `[]`.</ResponseField>
<ResponseField name="status" type="string">Payout status: `completed`, `pending`, or `notcompleted`.</ResponseField>
<ResponseField name="operator_id" type="string">Operator identifier. Example: `"11"` for Orange Burkina.</ResponseField>
<ResponseField name="operator_name" type="string">Operator name. Example: `"ORANGE BURKINA"`.</ResponseField>
<ResponseField name="wiki" type="string">URL to the sub-codes documentation.</ResponseField>

| `status`       | Meaning                       |
| -------------- | ----------------------------- |
| `completed`    | Payout finalized successfully |
| `pending`      | Processing in progress        |
| `notcompleted` | Payout failed                 |

<CodeGroup>
  ```json completed theme={null}
  {
    "response_code": "00",
    "token": "{PAYOUT_TOKEN}",
    "response_text": "",
    "description": "",
    "custom_data": [],
    "status": "completed",
    "operator_id": "11",
    "operator_name": "ORANGE BURKINA",
    "wiki": "https://client.ligdicash.com/wiki/createStraightWithdrawal"
  }
  ```

  ```json pending theme={null}
  {
    "response_code": "00",
    "token": "{PAYOUT_TOKEN}",
    "status": "pending",
    "operator_id": "",
    "operator_name": "",
    "wiki": "https://client.ligdicash.com/wiki/createStraightWithdrawal"
  }
  ```

  ```json API error theme={null}
  {
    "response_code": "01",
    "response_text": "Echec (Code01)",
    "wiki": "https://client.ligdicash.com/wiki/createStraightWithdrawal"
  }
  ```
</CodeGroup>

## Error codes

Wiki: `https://client.ligdicash.com/wiki/createStraightWithdrawal` — see [Sub-codes per endpoint](/en/errors/sub-codes#createstraightwithdrawal).

## Related guide

[Verify the status of a payout](/en/payment-api/payout/verify-status) — polling vs callback strategy.