{"openapi":"3.1.0","info":{"title":"Phone Number Tools","version":"1.0.0","description":"Parse, validate and format phone numbers worldwide from bundled libphonenumber metadata, with no dependency. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"Phone Number Tools: Parse, validate and format phone numbers worldwide from bundled libphonenumber metadata, with no dependency. Use /phone-parse to split a number, /phone-format for E.164, international, national and tel: forms, /phone-validate, /country-calling-codes, /phone-region-guess from a plus prefix, /phone-example for metadata sample numbers, /phone-compare and /phone-possible-lengths. Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://phone-tools.x402tookit.com"}],"paths":{"/country-calling-codes":{"get":{"operationId":"country_calling_codes","summary":"Look up which regions use a country calling code (+44, +1) or a region's code, dialing prefixes and national prefix.","description":"Look up which regions use a country calling code (+44, +1) or a region's code, dialing prefixes and national prefix.","tags":["phone","country-code","calling-code","lookup"],"parameters":[{"name":"code","in":"query","required":false,"description":"Calling code such as 44 or +44 (give code or region)","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"ISO region such as GB (give code or region)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"metadataBuiltOn":{"type":["null","string"]},"metadataSource":{"type":["null","string"]},"attribution":{"type":["null","string"]},"code":{"type":["null","number"]},"regions":{"type":["array","null"],"items":{"type":"object","properties":{"region":{"type":["null","string"]},"mainRegionForCode":{"type":["boolean","null"]},"internationalPrefix":{"type":["null","string"]},"nationalPrefix":{"type":["null","string"]}}}},"sharedCode":{"type":["boolean","null"]},"knownCodeCount":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"+44 is used by 4 regions (GB, GG, IM, JE).","reasons":["A shared code: the region of a full number is decided by its leading digits, use /phone-region-guess or /phone-parse."],"metadataBuiltOn":"2026-10-21","metadataSource":"https://github.com/google/libphonenumber","attribution":"Phone number metadata from Google's libphonenumber project (Apache 2.0)","code":44,"regions":[{"region":"GB","mainRegionForCode":true,"internationalPrefix":"00","nationalPrefix":"0"},{"region":"GG","mainRegionForCode":false,"internationalPrefix":"00","nationalPrefix":"0"}],"sharedCode":true,"knownCodeCount":207,"degraded":false,"notChecked":["whether any number range under the code is in service","the number of subscribers or operators"],"source":"Google libphonenumber metadata (Apache 2.0), bundled snapshot","asOf":"2026-10-21T05:54:57.422Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/country-calling-codes"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/country-calling-codes"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/country-calling-codes"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/country-calling-codes"}}]}}},"/phone-compare":{"get":{"operationId":"phone_compare","summary":"Compare two phone number strings: exact match, same national number, short match or different, with an optional region.","description":"Compare two phone number strings: exact match, same national number, short match or different, with an optional region.","tags":["phone","compare","match","dedupe"],"parameters":[{"name":"a","in":"query","required":true,"description":"First phone number string","schema":{"type":"string"}},{"name":"b","in":"query","required":true,"description":"Second phone number string","schema":{"type":"string"}},{"name":"default_region","in":"query","required":false,"description":"Region used to read numbers without + (e.g. US)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"match":{"type":["boolean","null"]},"strongMatch":{"type":["boolean","null"]},"level":{"type":["null","string"]},"detail":{"type":["null","object"],"properties":{"result":{"type":["null","string"]},"reason":{"type":["null","string"]}}},"usedDefaultRegion":{"type":["boolean","null"]},"metadataBuiltOn":{"type":["null","string"]},"metadataSource":{"type":["null","string"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"EXACT_MATCH","summary":"exact match: same country code and national number.","reasons":["Same country code and national number after removing punctuation and trunk prefix.","This says whether two strings denote the same number, nothing about who owns it."],"match":true,"strongMatch":true,"level":"EXACT_MATCH","detail":{"result":"EXACT_MATCH","reason":"same country code and national number"},"usedDefaultRegion":true,"metadataBuiltOn":"2026-10-21","metadataSource":"https://github.com/google/libphonenumber","attribution":"Phone number metadata from Google's libphonenumber project (Apache 2.0)","degraded":false,"notChecked":["whether the number is assigned, active, reachable or who it belongs to","carrier, portability, line status or geographic location","…2 more"],"source":"Google libphonenumber metadata (Apache 2.0), bundled snapshot","asOf":"2026-10-21T05:54:57.688Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-compare"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-compare"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-compare"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-compare"}}]}}},"/phone-example":{"get":{"operationId":"phone_example","summary":"Example phone numbers per region and type (fixed line, mobile, toll free, premium) taken from libphonenumber metadata.","description":"Example phone numbers per region and type (fixed line, mobile, toll free, premium) taken from libphonenumber metadata.","tags":["phone","example","test-data","libphonenumber"],"parameters":[{"name":"region","in":"query","required":true,"description":"ISO region such as DE, or 001 for non-geographic","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"fixed_line, mobile, toll_free, premium_rate, shared_cost, voip, personal_number, pager, uan, voicemail","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"region":{"type":["null","string"]},"countryCode":{"type":["null","number"]},"examples":{"type":["array","null"],"items":{"type":"object","properties":{"type":{"type":["null","string"]},"nationalNumber":{"type":["null","string"]},"e164":{"type":["null","string"]},"international":{"type":["null","string"]},"national":{"type":["null","string"]},"rfc3966":{"type":["null","string"]}}}},"metadataBuiltOn":{"type":["null","string"]},"metadataSource":{"type":["null","string"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"1 example number for DE, e.g. +49 1512 3456789 (mobile).","reasons":["These are documentation examples from the metadata; do not call or message them."],"region":"DE","countryCode":49,"examples":[{"type":"mobile","nationalNumber":"15123456789","e164":"+4915123456789","international":"+49 1512 3456789","national":"01512 3456789","rfc3966":"tel:+49-1512-3456789"}],"metadataBuiltOn":"2026-10-21","metadataSource":"https://github.com/google/libphonenumber","attribution":"Phone number metadata from Google's libphonenumber project (Apache 2.0)","degraded":false,"notChecked":["that the example is unassigned: these are format examples, not guaranteed unused numbers, so never dial them","regions without an example for the requested type"],"source":"Google libphonenumber metadata (Apache 2.0), bundled snapshot","asOf":"2026-10-21T05:54:57.952Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-example"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-example"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-example"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-example"}}]}}},"/phone-format":{"get":{"operationId":"phone_format","summary":"Format a phone number as E.164, international, national and RFC3966 tel: URI using the region's numbering-plan rules.","description":"Format a phone number as E.164, international, national and RFC3966 tel: URI using the region's numbering-plan rules.","tags":["phone","format","e164","rfc3966"],"parameters":[{"name":"number","in":"query","required":true,"description":"Phone number, E.164 (+...) or national format","schema":{"type":"string"}},{"name":"default_region","in":"query","required":false,"description":"ISO region for national numbers (required without +)","schema":{"type":"string"}},{"name":"format","in":"query","required":false,"description":"Only return one: e164, international, national or rfc3966","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"e164":{"type":["null","string"]},"international":{"type":["null","string"]},"national":{"type":["null","string"]},"rfc3966":{"type":["null","string"]},"countryCode":{"type":["null","number"]},"nationalNumber":{"type":["null","string"]},"region":{"type":["null","string"]},"valid":{"type":["boolean","null"]},"metadataBuiltOn":{"type":["null","string"]},"metadataSource":{"type":["null","string"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FORMATTED","summary":"+1 201-555-0123 (national: (201) 555-0123).","reasons":["Formatted using the rules of US (code +1 is shared)."],"e164":"+12015550123","international":"+1 201-555-0123","national":"(201) 555-0123","rfc3966":"tel:+1-201-555-0123","countryCode":1,"nationalNumber":"2015550123","region":"US","valid":true,"metadataBuiltOn":"2026-10-21","metadataSource":"https://github.com/google/libphonenumber","attribution":"Phone number metadata from Google's libphonenumber project (Apache 2.0)","degraded":false,"notChecked":["whether the number is assigned, active, reachable or who it belongs to","carrier, portability, line status or geographic location","…1 more"],"source":"Google libphonenumber metadata (Apache 2.0), bundled snapshot","asOf":"2026-10-21T05:54:58.220Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-format"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-format"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-format"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-format"}}]}}},"/phone-parse":{"get":{"operationId":"phone_parse","summary":"Parse a phone number (E.164 or national) into country code, national number, region, number type and validity.","description":"Parse a phone number (E.164 or national) into country code, national number, region, number type and validity.","tags":["phone","parse","e164","libphonenumber"],"parameters":[{"name":"number","in":"query","required":true,"description":"Phone number, E.164 (+...) or national format","schema":{"type":"string"}},{"name":"default_region","in":"query","required":false,"description":"ISO region for national numbers (required without +), e.g. US","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"parsed":{"type":["boolean","null"]},"countryCode":{"type":["null","number"]},"nationalNumber":{"type":["null","string"]},"extension":{},"region":{"type":["null","string"]},"possibleRegions":{"type":["array","null"],"items":{"type":"string"}},"regionsWhereValid":{"type":["array","null"],"items":{"type":"string"}},"numberType":{"type":["null","string"]},"valid":{"type":["boolean","null"]},"lengthCheck":{"type":["null","string"]},"countryCodeSource":{"type":["null","string"]},"e164":{"type":["null","string"]},"metadataBuiltOn":{"type":["null","string"]},"metadataSource":{"type":["null","string"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"VALID","summary":"+1 2015550123: valid fixed line or mobile (cannot tell apart) number in US.","reasons":["Country calling code +1 is shared by US, AG, AI, AS, BB, BM, BS, CA, DM, DO, GD, GU, JM, KN, KY, LC, MP, MS, PR, SX, TC, TT, VC, VG, VI; the region was chosen from the number's leading digits.","This numbering plan does not separate fixed and mobile numbers.","…1 more"],"parsed":true,"countryCode":1,"nationalNumber":"2015550123","extension":null,"region":"US","possibleRegions":["US","AG","…23 more"],"regionsWhereValid":["US"],"numberType":"FIXED_LINE_OR_MOBILE","valid":true,"lengthCheck":"IS_POSSIBLE","countryCodeSource":"default_region","e164":"+12015550123","metadataBuiltOn":"2026-10-21","metadataSource":"https://github.com/google/libphonenumber","attribution":"Phone number metadata from Google's libphonenumber project (Apache 2.0)","degraded":false,"notChecked":["whether the number is assigned, active, reachable or who it belongs to","carrier, portability, line status or geographic location","…1 more"],"source":"Google libphonenumber metadata (Apache 2.0), bundled snapshot","asOf":"2026-10-21T05:54:58.484Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-parse"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-parse"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-parse"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-parse"}}]}}},"/phone-possible-lengths":{"get":{"operationId":"phone_possible_lengths","summary":"Possible national phone number lengths for a region overall and per type, with local-only lengths and the E.164 total.","description":"Possible national phone number lengths for a region overall and per type, with local-only lengths and the E.164 total.","tags":["phone","length","numbering-plan","validation"],"parameters":[{"name":"region","in":"query","required":true,"description":"ISO region such as JP, or 001","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Limit to one type: fixed_line, mobile, toll_free, premium_rate, ...","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"region":{"type":["null","string"]},"countryCode":{"type":["null","number"]},"nationalLengths":{"type":["array","null"],"items":{"type":"number"}},"localOnlyLengths":{"type":["array","null"]},"e164TotalDigits":{"type":["array","null"],"items":{"type":"number"}},"byType":{"type":["null","object"],"properties":{"fixed_line":{"type":["null","object"],"properties":{"available":{"type":["boolean","null"]},"nationalLengths":{"type":["array","null"],"items":{"type":"number"}},"localOnlyLengths":{"type":["array","null"]},"inheritedFromGeneral":{"type":["boolean","null"]}}},"mobile":{"type":["null","object"],"properties":{"available":{"type":["boolean","null"]},"nationalLengths":{"type":["array","null"],"items":{"type":"number"}},"localOnlyLengths":{"type":["array","null"]},"inheritedFromGeneral":{"type":["boolean","null"]}}},"toll_free":{"type":["null","object"],"properties":{"available":{"type":["boolean","null"]},"nationalLengths":{"type":["array","null"],"items":{"type":"number"}},"localOnlyLengths":{"type":["array","null"]},"inheritedFromGeneral":{"type":["boolean","null"]}}},"premium_rate":{"type":["null","object"],"properties":{"available":{"type":["boolean","null"]},"nationalLengths":{"type":["array","null"],"items":{"type":"number"}},"localOnlyLengths":{"type":["array","null"]},"inheritedFromGeneral":{"type":["boolean","null"]}}},"voip":{"type":["null","object"],"properties":{"available":{"type":["boolean","null"]},"nationalLengths":{"type":["array","null"],"items":{"type":"number"}},"localOnlyLengths":{"type":["array","null"]},"inheritedFromGeneral":{"type":["boolean","null"]}}},"personal_number":{"type":["null","object"],"properties":{"available":{"type":["boolean","null"]},"nationalLengths":{"type":["array","null"],"items":{"type":"number"}},"localOnlyLengths":{"type":["array","null"]},"inheritedFromGeneral":{"type":["boolean","null"]}}},"pager":{"type":["null","object"],"properties":{"available":{"type":["boolean","null"]},"nationalLengths":{"type":["array","null"],"items":{"type":"number"}},"localOnlyLengths":{"type":["array","null"]},"inheritedFromGeneral":{"type":["boolean","null"]}}},"uan":{"type":["null","object"],"properties":{"available":{"type":["boolean","null"]},"nationalLengths":{"type":["array","null"],"items":{"type":"number"}},"localOnlyLengths":{"type":["array","null"]},"inheritedFromGeneral":{"type":["boolean","null"]}}}}},"metadataBuiltOn":{"type":["null","string"]},"metadataSource":{"type":["null","string"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"JP (+81): national numbers are 8, 9, 10, 11, 12, 13, 14, 15, 16, 17 digits long.","reasons":["Digits count the national significant number, without the country code or trunk prefix."],"region":"JP","countryCode":81,"nationalLengths":[8,9],"localOnlyLengths":[],"e164TotalDigits":[10,11],"byType":{"fixed_line":{"available":true,"nationalLengths":[9],"localOnlyLengths":[],"inheritedFromGeneral":false},"mobile":{"available":true,"nationalLengths":[10],"localOnlyLengths":[],"inheritedFromGeneral":false},"toll_free":{"available":true,"nationalLengths":[8,9],"localOnlyLengths":[],"inheritedFromGeneral":false},"premium_rate":{"available":true,"nationalLengths":[9],"localOnlyLengths":[],"inheritedFromGeneral":false},"voip":{"available":true,"nationalLengths":[10],"localOnlyLengths":[],"inheritedFromGeneral":false},"personal_number":{"available":true,"nationalLengths":[9],"localOnlyLengths":[],"inheritedFromGeneral":false},"pager":{"available":true,"nationalLengths":[10],"localOnlyLengths":[],"inheritedFromGeneral":false},"uan":{"available":true,"nationalLengths":[9],"localOnlyLengths":[],"inheritedFromGeneral":false}},"metadataBuiltOn":"2026-10-21","metadataSource":"https://github.com/google/libphonenumber","attribution":"Phone number metadata from Google's libphonenumber project (Apache 2.0)","degraded":false,"notChecked":["whether a number of a possible length is valid (use /phone-validate)","emergency and short-code lengths"],"source":"Google libphonenumber metadata (Apache 2.0), bundled snapshot","asOf":"2026-10-21T05:54:58.749Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-possible-lengths"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-possible-lengths"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-possible-lengths"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-possible-lengths"}}]}}},"/phone-region-guess":{"get":{"operationId":"phone_region_guess","summary":"Guess the region from an international +prefix or partial number: calling code, candidate regions and how certain it is.","description":"Guess the region from an international +prefix or partial number: calling code, candidate regions and how certain it is.","tags":["phone","region","country-code","prefix"],"parameters":[{"name":"prefix","in":"query","required":true,"description":"International number or prefix starting with +, e.g. +4420 or +1649","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"guessed":{"type":["boolean","null"]},"countryCode":{"type":["null","number"]},"remainingDigits":{"type":["null","string"]},"regionsForCode":{"type":["array","null"],"items":{"type":"string"}},"candidates":{"type":["array","null"],"items":{"type":"string"}},"mostLikelyRegion":{"type":["null","string"]},"certain":{"type":["boolean","null"]},"mainRegionForCode":{"type":["null","string"]},"metadataBuiltOn":{"type":["null","string"]},"metadataSource":{"type":["null","string"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"REGION_FOUND","summary":"+1 649 points to TC.","reasons":["Candidates are the regions whose numbering plan can contain a number starting with these digits.","A region guess from a prefix is a numbering-plan fact, not a location of the person."],"guessed":true,"countryCode":1,"remainingDigits":"649","regionsForCode":["US","AG","…23 more"],"candidates":["TC"],"mostLikelyRegion":"TC","certain":true,"mainRegionForCode":"US","metadataBuiltOn":"2026-10-21","metadataSource":"https://github.com/google/libphonenumber","attribution":"Phone number metadata from Google's libphonenumber project (Apache 2.0)","degraded":false,"notChecked":["whether any number under the prefix is assigned","the actual location of the subscriber (numbers can be portable or roam)"],"source":"Google libphonenumber metadata (Apache 2.0), bundled snapshot","asOf":"2026-10-21T05:54:59.015Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-region-guess"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-region-guess"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-region-guess"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-region-guess"}}]}}},"/phone-validate":{"get":{"operationId":"phone_validate","summary":"Validate a phone number against the numbering plan: possible length, valid pattern, optionally for one region. Syntax only.","description":"Validate a phone number against the numbering plan: possible length, valid pattern, optionally for one region. Syntax only.","tags":["phone","validate","e164","numbering-plan"],"parameters":[{"name":"number","in":"query","required":true,"description":"Phone number, E.164 (+...) or national format","schema":{"type":"string"}},{"name":"default_region","in":"query","required":false,"description":"ISO region for national numbers (required without +)","schema":{"type":"string"}},{"name":"for_region","in":"query","required":false,"description":"Require validity in this region, e.g. GB (others are rejected)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"valid":{"type":["boolean","null"]},"reason":{"type":["null","string"]},"possible":{"type":["boolean","null"]},"lengthCheck":{"type":["null","string"]},"numberType":{"type":["null","string"]},"countryCode":{"type":["null","number"]},"nationalNumber":{"type":["null","string"]},"region":{"type":["null","string"]},"regionsWhereValid":{"type":["array","null"],"items":{"type":"string"}},"forRegionResult":{"type":["null","object"],"properties":{"region":{"type":["null","string"]},"valid":{"type":["boolean","null"]},"reason":{"type":["null","string"]}}},"e164":{"type":["null","string"]},"metadataBuiltOn":{"type":["null","string"]},"metadataSource":{"type":["null","string"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"VALID","summary":"+44 2012345678: valid (VALID) for GB.","reasons":["Valid means the digits fit a numbering plan range; it never means the number is assigned or reachable."],"valid":true,"reason":"VALID","possible":true,"lengthCheck":"IS_POSSIBLE","numberType":"FIXED_LINE","countryCode":44,"nationalNumber":"2012345678","region":"GB","regionsWhereValid":["GB"],"forRegionResult":{"region":"GB","valid":true,"reason":"valid in that region"},"e164":"+442012345678","metadataBuiltOn":"2026-10-21","metadataSource":"https://github.com/google/libphonenumber","attribution":"Phone number metadata from Google's libphonenumber project (Apache 2.0)","degraded":false,"notChecked":["whether the number is assigned, active, reachable or who it belongs to","carrier, portability, line status or geographic location","…1 more"],"source":"Google libphonenumber metadata (Apache 2.0), bundled snapshot","asOf":"2026-10-21T05:54:59.281Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-validate"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-validate"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-validate"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://phone-tools.x402tookit.com/phone-validate"}}]}}}}}