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

# List withdrawal requests

> List the user's withdrawal requests and their status.

## Query parameters

<ParamField query="limit" type="integer">
  Maximum number of items to return.

  Maximum: `9007199254740991`
</ParamField>

<ParamField query="from" type="integer">
  Start of the date range.

  Maximum: `9007199254740991`
</ParamField>

<ParamField query="to" type="integer">
  End of the date range.

  Maximum: `9007199254740991`
</ParamField>

## Response

`200` Success.

<ResponseField name="page" type="number" />

<ResponseField name="limit" type="number" />

<ResponseField name="count" type="number" />

<ResponseField name="hasNextPage" type="boolean" />

<ResponseField name="hasPrevPage" type="boolean" />

<ResponseField name="totalPages" type="number" />

<ResponseField name="result" type="object[]">
  <Expandable title="properties">
    <ResponseField name="accountId" type="string" />

    <ResponseField name="amount" type="number" />

    <ResponseField name="fromCurrency" type="string" />

    <ResponseField name="exchange_rate" type="number" />

    <ResponseField name="convertedAmount" type="number" />

    <ResponseField name="toCurrency" type="string" />

    <ResponseField name="createdAt" type="string<date-time>">
      Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$`
    </ResponseField>

    <ResponseField name="transactionId" type="string" />

    <ResponseField name="paymentGatewayName" type="string" />

    <ResponseField name="processedComment" type="string" />

    <ResponseField name="creditCard" type="object">
      <Expandable title="properties">
        <ResponseField name="lastFourDigits" type="string" />

        <ResponseField name="typeName" type="string" />
      </Expandable>
    </ResponseField>

    <ResponseField name="bankAccount" type="object">
      <Expandable title="properties">
        <ResponseField name="bankName" type="string" />

        <ResponseField name="iban" type="string" />
      </Expandable>
    </ResponseField>

    <ResponseField name="ewallet" type="object">
      <Expandable title="properties">
        <ResponseField name="typeName" type="string" />

        <ResponseField name="email" type="string" />
      </Expandable>
    </ResponseField>

    <ResponseField name="transaction" type="object">
      <Expandable title="properties">
        <ResponseField name="status" type="enum<string>">
          Available options: `PENDING`, `PROCESSING`, `CANCELLED`, `START_PROCESSING`, `PENDING_PSP_PROCESSING`, `COMPLETED`, `REJECTED`, `ERROR`, `DIVIDED`
        </ResponseField>

        <ResponseField name="id" type="number" />

        <ResponseField name="transactionId" type="string" />

        <ResponseField name="referenceNumber" type="number" />

        <ResponseField name="completedAt" type="string<date-time>">
          Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$`
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

## Possible Errors

| Error | Possible cause | What to do |
| - | - | - |
| 400 | Invalid or missing field, amount outside limits | Check the request against the schema and the instrument's size limits. |
| 401 | Token missing or expired | Log in again or use the refresh token. |
| 403 | IP not whitelisted, or account restricted | Confirm your IP is whitelisted; otherwise contact Amana. |
| 404 | The requested item doesn't exist | Check the ID or path parameter. |
| 429 / 5xx | Rate limit, or temporary issue on our side | Retry with backoff; contact support if it persists. |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://gateway.amana.io/transactions/withdrawal-requests' \
    --header 'Authorization: Bearer <token>'
  ```

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

  url = "https://gateway.amana.io/transactions/withdrawal-requests"
  headers = {"Authorization": "Bearer <token>"}

  response = requests.request("GET", url, headers=headers)
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://gateway.amana.io/transactions/withdrawal-requests', {
    method: 'GET',
    headers: {"Authorization": "Bearer <token>"},
  });
  console.log(await response.json());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "page": 123.45,
    "limit": 123.45,
    "count": 123.45,
    "hasNextPage": true,
    "hasPrevPage": true,
    "totalPages": 123.45,
    "result": [
      {
        "accountId": "<string>",
        "amount": 123.45,
        "fromCurrency": "<string>",
        "exchange_rate": 123.45,
        "convertedAmount": 123.45,
        "toCurrency": "<string>",
        "createdAt": "2026-01-01T00:00:00Z",
        "transactionId": "<string>",
        "paymentGatewayName": "<string>",
        "processedComment": "<string>",
        "creditCard": {
          "lastFourDigits": "<string>",
          "typeName": "<string>"
        },
        "bankAccount": {
          "bankName": "<string>",
          "iban": "<string>"
        },
        "ewallet": {
          "typeName": "<string>",
          "email": "<string>"
        },
        "transaction": {
          "status": "PENDING",
          "id": 123.45,
          "transactionId": "<string>",
          "referenceNumber": 123.45,
          "completedAt": "2026-01-01T00:00:00Z"
        }
      }
    ]
  }
  ```

  ```json 400 theme={null}
  {
    "error": "<string>",
    "message": "<string>",
    "details": {}
  }
  ```

  ```json 401 theme={null}
  {
    "error": "<string>",
    "message": "<string>",
    "details": {}
  }
  ```

  ```json 403 theme={null}
  {
    "error": "<string>",
    "message": "<string>"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "<string>",
    "message": "<string>",
    "details": {}
  }
  ```

  ```json 429 theme={null}
  {
    "error": "<string>",
    "message": "<string>"
  }
  ```

  ```json 500 theme={null}
  {
    "error": "<string>",
    "message": "<string>",
    "details": {}
  }
  ```
</ResponseExample>


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