{"openapi":"3.1.0","info":{"title":"NumberIntel","version":"1.1.0","description":"Pay-per-call NANP phone number intelligence for AI agents, paid via x402 (USDC on Base).","x-guidance":"No API key or signup. Call GET /v1/npa?npa=480 for area-code geo/timezone data, or GET /v1/number?number=+14805550100 for normalization/validity/plausibility. First request returns HTTP 402 with x402 payment requirements (USDC on Base, eip155:8453); pay $0.002 per call and retry with the payment signature. Free schema preview at /v1/sample (5 req/min).","contact":{"email":"ebeau97@gmail.com"}},"servers":[{"url":"https://numberintel.dev"}],"paths":{"/v1/npa":{"get":{"summary":"NANP area code intelligence","description":"Region, state, country, timezones, current local time, toll-free/premium/geographic flags for a 3-digit NANP area code.","parameters":[{"name":"npa","in":"query","required":true,"description":"3-digit NANP area code, e.g. 480","schema":{"type":"string","pattern":"^[0-9]{3}$"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Area code record","content":{"application/json":{"schema":{"type":"object","properties":{"npa":{"type":"string"},"region":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"timezones":{"type":"array","items":{"type":"string"}},"local_time":{"type":"array","items":{"type":"object","properties":{"tz":{"type":"string"},"time":{"type":"string"}}}},"toll_free":{"type":"boolean"},"premium_rate":{"type":"boolean"},"geographic":{"type":"boolean"}}},"example":{"npa":"602","region":"Arizona","state":"US-AZ","country":"US","timezones":["America/Phoenix"],"local_time":[{"tz":"America/Phoenix","time":"Sun 20:30"}],"toll_free":false,"premium_rate":false,"geographic":true}}}},"400":{"description":"Malformed area code"},"402":{"description":"Payment Required"},"404":{"description":"Unknown area code"}}}},"/v1/number":{"get":{"summary":"Phone number static intelligence","description":"E.164 normalization, format validity, plausibility, geography, timezones and local time for a NANP phone number.","parameters":[{"name":"number","in":"query","required":true,"description":"NANP phone number in any common format, e.g. +16022966261","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Number analysis","content":{"application/json":{"schema":{"type":"object","properties":{"valid_format":{"type":"boolean"},"e164":{"type":"string"},"npa":{"type":"string"},"npa_known":{"type":"boolean"},"plausible":{"type":"boolean"},"geo":{"type":["object","null"],"properties":{"region":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"}}},"timezones":{"type":"array","items":{"type":"string"}},"toll_free":{"type":"boolean"},"premium_rate":{"type":"boolean"}}},"example":{"valid_format":true,"e164":"+16022966261","npa":"602","npa_known":true,"plausible":true,"geo":{"region":"Arizona","state":"US-AZ","country":"US"},"timezones":["America/Phoenix"],"local_time":[{"tz":"America/Phoenix","time":"Sun 20:30"}],"toll_free":false,"premium_rate":false}}}},"400":{"description":"Malformed number"},"402":{"description":"Payment Required"}}}},"/v1/sample":{"get":{"summary":"Free rate-limited preview","description":"Free preview of /v1/npa or /v1/number output for schema validation. 5 requests/minute per IP.","parameters":[{"name":"npa","in":"query","required":false,"description":"3-digit area code","schema":{"type":"string"}},{"name":"number","in":"query","required":false,"description":"NANP phone number","schema":{"type":"string"}}],"responses":{"200":{"description":"Sample data"},"429":{"description":"Rate limited"}}}},"/health":{"get":{"summary":"Service health","responses":{"200":{"description":"OK"}}}}}}