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

# List requests

> Your recent requests, newest first, with counts and credits. No contact details. Free.

> [!NOTE]
>
> Every call is saved for 30 days, then deleted, unless you turn history off in Settings. Billing records are kept separately and hold no contact details.

## Query

**kind** `string`

`check_numbers`, `find_mobiles` or `csv_check` to show one kind of request.

**limit** `integer` (default: 50)

How many to return, newest first. 1 to 200.

## Response

**requests** `object[]` *required*

**properties**

**id** `string`

The request id. The same value as the `X-Request-Id` header on the original call.

**kind** `string`

`check_numbers`, `find_mobiles` or `csv_check`.

**source** `string`

Where it came from: `api`, `mcp`, `csv` or `dashboard`.

**status** `string`

`queued`, `running`, `complete`, `partial` or `failed`.

**created\_at** `string`

ISO 8601 time the request was made.

**completed\_at** `string | null`

ISO 8601 time it finished.

**expires\_at** `string`

When it is deleted, 30 days after it was made.

**input\_count** `integer`

How many contacts were sent.

**processed\_count** `integer`

How many were processed.

**counts** `object`

How many results got each priority, and how many could not be checked.

**credits\_charged** `integer`

What the request cost in total.

**history\_saved** `boolean` *required*

`false` when history is turned off in Settings, so new calls are not being saved.

```bash cURL theme={null}
curl https://app.willthispersonanswer.com/api/v1/requests \
  -H "Authorization: Bearer $WTPA_API_KEY"
```

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

res = requests.get(
    "https://app.willthispersonanswer.com/api/v1/requests",
    headers={"Authorization": f"Bearer {os.environ['WTPA_API_KEY']}"},
)
print(res.json())
```

```javascript JavaScript theme={null}
const res = await fetch("https://app.willthispersonanswer.com/api/v1/requests", {
  headers: { Authorization: `Bearer ${process.env.WTPA_API_KEY}` },
});
console.log(await res.json());
```

```json 200 theme={null}
{
  "requests": [
    {
      "id": "6f1c2a9e-4b7d-4e2a-9c51-0d8a7e3b5f12",
      "kind": "check_numbers",
      "source": "api",
      "status": "complete",
      "created_at": "2026-10-27T09:14:02Z",
      "completed_at": "2026-10-27T09:14:03Z",
      "expires_at": "2026-11-26T09:14:02Z",
      "input_count": 1,
      "processed_count": 1,
      "counts": {
        "total": 1, "A1": 1, "A2": 0,
        "A3": 0, "X": 0
      },
      "credits_charged": 2
    }
  ],
  "history_saved": true
}
```


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