curl https://app.willthispersonanswer.com/api/v1/requests \
-H "Authorization: Bearer $WTPA_API_KEY"
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())
const res = await fetch("https://app.willthispersonanswer.com/api/v1/requests", {
headers: { Authorization: `Bearer ${process.env.WTPA_API_KEY}` },
});
console.log(await res.json());
{
"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
}
Request history
List requests
Your recent requests, newest first, with counts and credits. No contact details. Free.
GET
/
requests
curl https://app.willthispersonanswer.com/api/v1/requests \
-H "Authorization: Bearer $WTPA_API_KEY"
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())
const res = await fetch("https://app.willthispersonanswer.com/api/v1/requests", {
headers: { Authorization: `Bearer ${process.env.WTPA_API_KEY}` },
});
console.log(await res.json());
{
"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
}
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
string
check_numbers, find_mobiles or csv_check to show one kind of request.integer
default:"50"
How many to return, newest first. 1 to 200.
Response
object[]
required
Show properties
Show properties
string
The request id. The same value as the
X-Request-Id header on the original call.string
check_numbers, find_mobiles or csv_check.string
Where it came from:
api, mcp, csv or dashboard.string
queued, running, complete, partial or failed.string
ISO 8601 time the request was made.
string | null
ISO 8601 time it finished.
string
When it is deleted, 30 days after it was made.
integer
How many contacts were sent.
integer
How many were processed.
object
How many results got each priority, and how many could not be checked.
integer
What the request cost in total.
boolean
required
false when history is turned off in Settings, so new calls are not being saved.curl https://app.willthispersonanswer.com/api/v1/requests \
-H "Authorization: Bearer $WTPA_API_KEY"
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())
const res = await fetch("https://app.willthispersonanswer.com/api/v1/requests", {
headers: { Authorization: `Bearer ${process.env.WTPA_API_KEY}` },
});
console.log(await res.json());
{
"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
}