{"openapi":"3.1.0","info":{"title":"Phone Validation API","version":"1.0.0","description":"Validate, parse and format phone numbers using Google libphonenumber: validity check, E.164 / national / international / RFC-3966 formats, country and calling code detection, and line type (mobile, fixed-line, VoIP, toll-free, premium-rate). Covers every country.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/phone-api","description":"oanor gateway"}],"tags":[{"name":"Validation"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/example":{"get":{"operationId":"get_v1_example","tags":["Validation"],"summary":"Example valid number for a country","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"2-letter ISO country code","schema":{"type":"string"},"example":"US"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"e164":"+12015550123","valid":true,"country":"US","rfc3966":"tel:+12015550123","possible":true,"line_type":"FIXED_LINE_OR_MOBILE","country_name":"United States","national_format":"(201) 555-0123","national_number":"2015550123","country_calling_code":"+1","international_format":"+1 201 555 0123"},"meta":{"timestamp":"2026-05-29T22:25:38.904Z","request_id":"982ea34a-52cc-4cba-8bc7-244a360dd51a"},"status":"ok","message":"Example number retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/verify":{"get":{"operationId":"get_v1_verify","tags":["Validation"],"summary":"Validate + parse a phone number","description":"","parameters":[{"name":"phone","in":"query","required":true,"description":"E.164 (+14155552671) or national number","schema":{"type":"string"},"example":"+14155552671"},{"name":"country","in":"query","required":false,"description":"2-letter ISO country for national numbers","schema":{"type":"string"},"example":"US"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"e164":"+14155552671","input":"+14155552671","valid":true,"country":"US","rfc3966":"tel:+14155552671","possible":true,"line_type":"FIXED_LINE_OR_MOBILE","country_name":"United States","national_format":"(415) 555-2671","national_number":"4155552671","country_calling_code":"+1","international_format":"+1 415 555 2671"},"meta":{"timestamp":"2026-05-29T22:25:38.959Z","request_id":"615c3a48-5ba0-4829-bb7a-e22940f47063"},"status":"ok","message":"Phone number verified successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1000,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1200,"monthly_call_quota":25000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3900,"monthly_call_quota":150000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":9900,"monthly_call_quota":600000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/phone-api"}