Skip to content
Category

Parse Angolan numbers and classify the numbering range.

The phone routes normalize local or international input, separate country and national parts, and map mobile prefixes to Unitel, Africell, or Movicel when the range is known.

Routes

3 GET

Country code

+244

Availability model

Numbering plan

Routes in this family

RoutePurposeKey query
/api/v1/phone/parseReturn structured phone-number components and formats.phone
/api/v1/phone/validateValidate format and report numbering-plan availability.phone
/api/v1/phone/operatorDetect the mobile operator from the range prefix.phone

GET /api/v1/phone/parse

Use parse when you need a canonical normalized number plus reusable formatting for storage or UI.

ParameterRequiredDescription
phoneYesLocal or international Angolan number, such as `923456789` or `+244923456789`.
GNU BashcURL usage
curl -s "https://utils.api.orb3x.com/api/v1/phone/parse?phone=%2B244923456789"
JSON200 response
{  "normalized": "+244923456789",  "countryCode": "+244",  "nationalNumber": "923456789",  "internationalFormat": "+244 923 456 789",  "nationalFormat": "923 456 789",  "isMobile": true,  "type": "mobile",  "prefix": "92",  "subscriberNumber": "3456789",  "operator": {    "code": "UNITEL",    "name": "Unitel",    "prefix": "92",    "prefixes": ["92", "93", "94"]  }}
JSONError response
{  "error": {    "code": "INVALID_PHONE",    "message": "Angolan phone numbers must contain 9 national digits.",    "field": "phone",    "length": 6  }}

GET /api/v1/phone/validate

Use validate when you need a pass/fail result plus numbering-plan availability information.

ParameterRequiredDescription
phoneYesLocal or international Angolan phone number.
GNU BashcURL usage
curl -s "https://utils.api.orb3x.com/api/v1/phone/validate?phone=952345678"
JSON200 response
{  "isValid": true,  "normalized": "+244952345678",  "type": "mobile",  "operator": {    "code": "AFRICELL",    "name": "Africell",    "prefix": "95",    "prefixes": ["95"]  },  "availability": {    "type": "numbering-plan",    "status": "allocated-range",    "canConfirmLiveSubscriber": false  }}
JSONError response
{  "error": {    "code": "INVALID_PHONE",    "message": "The \"phone\" query parameter is required.",    "field": "phone"  }}
Availability is based on known Angolan numbering ranges. It does not confirm live subscriber reachability.

GET /api/v1/phone/operator

Use operator when you need only the operator lookup and not the rest of the parsed phone payload.

ParameterRequiredDescription
phoneYesLocal or international Angolan phone number.
GNU BashcURL usage
curl -s "https://utils.api.orb3x.com/api/v1/phone/operator?phone=912345678"
JSON200 response
{  "phone": "912345678",  "operator": {    "code": "MOVICEL",    "name": "Movicel",    "prefix": "91",    "prefixes": ["91", "99"]  }}
JSONError response
{  "error": {    "code": "INVALID_PHONE",    "message": "Angolan phone numbers must contain 9 national digits.",    "field": "phone",    "length": 4  }}