curl https://app.willthispersonanswer.com/api/v1/requests/$ID \
-H "Authorization: Bearer $WTPA_API_KEY"
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())
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());
{
"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
}
}
]
}
{
"error": {
"code": "not_found",
"message": "No request with that id. It may have expired or been deleted."
}
}
Request history
Get request
One saved request with every result in it, each in the same shape the original call returned. Free.
GET
/
requests
/
{id}
curl https://app.willthispersonanswer.com/api/v1/requests/$ID \
-H "Authorization: Bearer $WTPA_API_KEY"
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())
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());
{
"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
}
}
]
}
{
"error": {
"code": "not_found",
"message": "No request with that id. It may have expired or been deleted."
}
}
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
string
required
The request id, from the
X-Request-Id header or List requests.Query
string
default:"legacy"
Send
priority to read next_action in the other wording.Response
The request summary, as in List requests, plus its rows.object[]
required
curl https://app.willthispersonanswer.com/api/v1/requests/$ID \
-H "Authorization: Bearer $WTPA_API_KEY"
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())
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());
{
"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
}
}
]
}
{
"error": {
"code": "not_found",
"message": "No request with that id. It may have expired or been deleted."
}
}