Api reference
Poll number purchase job
Poll provisioning progress after `POST /api/v1/numbers/buy/*`. **Auth:** Privy JWT or API key with `numbers:read` or `numbers:buy`.
Poll provisioning progress after POST /api/v1/numbers/buy/*.
Auth: Privy JWT or API key with numbers:read or numbers:buy.
Authorization
bearer AuthorizationBearer <token>
Privy access token (dashboard sessions, ~1h TTL) or long-lived dial_live_* / dial_test_* API key minted from /dashboard/billing. API keys are scope-gated per route (sms:send, numbers:read, account:read, etc.); Privy sessions bypass scope checks. See /docs/api-reference/api-keys for the full scope catalogue.
In: header
Query Parameters
jobId*string
Response Body
application/json
curl -X GET "https://payphone.wtf/api/v1/numbers/buy/status?jobId=string"Empty
Empty
Empty
{
"success": false,
"error": "missing_scope",
"required": "string",
"scopes": [
"string"
]
}Empty