{"openapi":"3.1.0","info":{"title":"Phone Validation API","version":"0.1.0","description":"Validate and format phone numbers of every country: valid or not and why, line type (mobile, fixed line, toll free, VoIP…), country, and E.164, international, national and tel: formats. Offline numbering-plan data from Google libphonenumber (via libphonenumber-js, MIT); no carrier lookup. Paid routes need a LicenRoute licence (Authorization: Bearer bgat_…)."},"components":{"securitySchemes":{"licence":{"type":"http","scheme":"bearer","description":"LicenRoute licence key (bgat_…)"}}},"paths":{"/v1/phone":{"get":{"summary":"Number of supported countries","security":[{"licence":[]}],"parameters":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid country code."},"402":{"description":"Payment required: no valid licence. The body names the plan and where to buy it."},"403":{"description":"Invented or revoked licence."}}}},"/v1/phone/validate/{number}":{"get":{"summary":"Validate and format a number","security":[{"licence":[]}],"parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string","example":"+14155552671"},"description":"Number as written; URL-encode spaces and '+' (%2B)"},{"name":"country","in":"query","required":false,"schema":{"type":"string","example":"US"},"description":"ISO country to read numbers without a +calling code"}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid country code."},"402":{"description":"Payment required: no valid licence. The body names the plan and where to buy it."},"403":{"description":"Invented or revoked licence."}}}},"/v1/phone/country/{country}":{"get":{"summary":"Calling code and an example mobile number","security":[{"licence":[]}],"parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string","example":"GB"},"description":"ISO 3166-1 alpha-2 code"}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid country code."},"402":{"description":"Payment required: no valid licence. The body names the plan and where to buy it."},"403":{"description":"Invented or revoked licence."}}}},"/health":{"get":{"summary":"Health check (free)","responses":{"200":{"description":"OK"}}}}}}