---
title: List pre-approvals
description: Page through your project's pre-approvals, most recent first.
api: GET /preapprovals
---

- **`status`** · query · `string`

  `pending`, `approved`, `failed`, `cancelled` or `expired`. Default: all.

- **`phone_number`** · query · `string`

  Only this customer's. Use the canonical form, with the `268` country code and no `+`.

- **`page`** · query · `integer` · default `1`

  Which page, starting at 1. See [pagination](/docs/concepts/pagination).

- **`limit`** · query · `integer` · default `25`

  Results per page, up to 100.

- **`q`** · query · `string`

  Search by `external_reference`, message or payer phone number. Case-insensitive, matches part of a value.

## Response

A [page](/docs/concepts/pagination) of [pre-approvals](/docs/api/create-preapproval#the-pre-approval-object), newest first.

- **`data`** · `array` · required

  The pre-approvals on this page.

- **`page`** · `integer` · required

  The page returned.

- **`limit`** · `integer` · required

  The page size used.

- **`total`** · `integer` · required

  How many match the filters and search across all pages.

- **`total_pages`** · `integer` · required

  How many pages there are at this `limit`; `0` when nothing matches. Keep requesting while `page < total_pages`.

```json 200
{
  "success": true,
  "message": "",
  "data": { "data": [], "page": 1, "limit": 25, "total": 0, "total_pages": 0 }
}
```