Verify v1 · Phone
Before calling these endpoints, use a Geoscape Hub application with access to this API product. Authenticate with your Consumer Key in the Authorization header. See Authentication, Error Handling, Rate Limiting, and Attribution for shared integration guidance.
Validate
Authentication: Use your Consumer Key in the
Authorizationheader.
Validate and format one phone number supplied in the JSON body. Example numbers are masked with x and illustrate the request and response formats. Replace them with a number you are authorised to validate before testing. Numbers without a country code are interpreted as Australian numbers.
validreports whether the parsed number matches a valid numbering range. It does not confirm ownership or connection- If parsing fails, the response has
valid: false,format: {}, and only theparsecheck. Unavailable detail fields are omitted - Unsupported body fields and query parameters return
400. A processed invalid number returns200
Requires paid-plan access. Each processed request costs 1 credit. See Interpreting Results for formats and number details.
Code
Validate › Request Body
phonePhone number to check. Digits, spaces, brackets, dashes, dots, plus signs, a national trunk prefix, an explicit country code, and international dialling prefixes are accepted. Numbers without a country code are interpreted as Australian numbers.
Validate › Responses
OK - the number was checked. A number that fails validation is still a 200.
attributionData attribution notice.
requestTimeStampUnix timestamp in seconds for the response.
requestDateTimeUTC date and time for the request.
The request body echoed exactly as supplied.
validTrue when the parsed number matches a valid numbering range. Mirrors number_details.valid; does not confirm ownership or connection.
Number formats. Always present. Fields are omitted when unavailable, and the object is empty when parsing fails.
What the number itself tells us. Always present. Unavailable values are omitted.
Checks performed, credit cost, request ID, and processing time. Always present.