Validate a phone number and return its type / region
Parses a phone number and returns whether it's a valid dialable number for the given region, its E.164 normalization, ITU country code, ISO region code, and type classification (mobile, fixed_line, toll_free, voip, etc.). Any dialing extension ('...ext 22') is captured in a separate extension field, since E.164 drops it. Backed by Google's libphonenumber. Default country hint is 'US' - pass country_hint with an ISO 3166-1 alpha-2 code (e.g. 'GB', 'CA') to parse non-US numbers that lack a leading '+'. Invalid numbers return confidence=0.0 with a reason, not an HTTP error.
Request
- Base URL: https://api.snipget.ai (the document declares no server; this is the origin it was published from)
- URL: https://api.snipget.ai/v1/phone/validate
- Auth: none declared
Query parameters
Set true to attach an execution receipt at meta.receipt — caller-verifiable sha256 hashes over the RFC 8785 (JCS) canonicalization of this call's as-received JSON body and its result (free, like include_trace). Reproduce with any JCS library: input_hash = sha256(jcs({"tool": <request path>, "args": <your body minus include_trace/include_receipt>})); result_hash = sha256(jcs(result)). For deterministic tools, same input on the same build reproduces result_hash.
Headers
Request body
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.