> ## 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.

# Get request

> One saved request with every result in it, each in the same shape the original call returned. 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.

## Path

**id** `string` *required*

The request id, from the `X-Request-Id` header or [List requests](https://docs.willthispersonanswer.com/api-reference/list-requests.md).

## Query

**action\_vocabulary** `string` (default: legacy)

Send `priority` to read `next_action` in the other wording.

## Response

The request summary, as in [List requests](https://docs.willthispersonanswer.com/api-reference/list-requests.md), plus its rows.

**rows** `object[]` *required*

**properties**

**position** `integer`

The contact's place in the request, from 0.

**status** `string`

`done`, `unable`, `not_processed`, `duplicate` or `pending`.

**input** `object`

What you sent for that contact.

**result** `object | null`

The result, in the shape Find Mobile or Check Number returned it.

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

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

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

```javascript JavaScript theme={null}
const BASE = "https://app.willthispersonanswer.com/api/v1";

const res = await fetch(`${BASE}/requests/${requestId}`, {
  headers: { Authorization: `Bearer ${process.env.WTPA_API_KEY}` },
});
console.log(await res.json());
```

```json 200 theme={null}
{
  "id": "6f1c2a9e-4b7d-4e2a-9c51-0d8a7e3b5f12",
  "kind": "check_numbers",
  "status": "complete",
  "created_at": "2026-10-27T09:14:02Z",
  "credits_charged": 2,
  "rows": [
    {
      "position": 0,
      "status": "done",
      "input": {
        "first_name": "Ada",
        "last_name": "Lovelace",
        "phone": "+12025550147"
      },
      "result": {
        "status": "success",
        "priority": {
          "classification": "A1",
          "label": "High priority",
          "next_action": "prioritise_calling"
        },
        "credit_cost": 2
      }
    }
  ]
}
```

```json 404 theme={null}
{
  "error": {
    "code": "not_found",
    "message": "No request with that id. It may have expired or been deleted."
  }
}
```


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