Skip to content
Spaw
Get your API key

PHONE_BLOCK_NOT_FOUND

No number block matches that country and prefix

GET /api/v1/phone/block/{country}/{prefix} found nothing to report: either no numbering plan Spaw syncs covers the country, or no block in it starts with the prefix. Nothing is charged.

http status
404
credits
Nothing is billed for a failed request.

What it means

The block report is read from the regulators' own allocation tables, which Spaw syncs per country. A country whose regulator publishes no such table has no rows and answers this code. The Crown dependencies (GG, JE, IM) are filed under GB's table and answered from it, keeping only their own blocks, so a prefix that reaches outside them — /api/v1/phone/block/gg/20 is London — answers this code too.

A covered country answers it when the prefix simply is not in the plan: the digits are longer than any block, or they name a range the regulator has never opened. Validating a single number is unaffected; it works from the same tables and answers a verdict rather than this code.

What to do

Check the country is one whose numbering plan Spaw carries, and shorten the prefix to the area code itself — the report covers every block underneath it.

Example response 

{
    "success": false,
    "error": {
        "code": "PHONE_BLOCK_NOT_FOUND",
        "message": "No number block in US starts with 999.",
        "request_id": "req_01m1kgdm4xngzmbmff68g94w0c"
    }
}

Every error carries the request_id also sent in the X-Request-Id header; quote it when writing to support.

Related

markdown version: /docs/errors/PHONE_BLOCK_NOT_FOUND.md