Supply the country calling code.
A leading plus is optional and 00 is accepted in its place. A national-format number without a country code is rejected rather than guessed into another real number.
Start with the number. Get the context.
Read the country, serving network, original network and coarse line type in one base lookup. Add only the properties your decision needs.
A number enters.
A contact path emerges.
Inspect the base record and the difference between serving and issuing networks.
NL
PHONE NUMBER+31 6 1234 5678
Mobile · Netherlands- Serving network
- Vodafone
- Issuing network
- KPN
- Base flag
ported
KPNVodafoneThe serving network differs from the issuing network.
Base responseAnswered
phone_number: "+31612345678"
country_code: "NL"
line_type: "mobile"
flags: ["ported"]Prepare the recipient check
The number is a mobile line with network context. Verify recipient control separately before granting account access.
Next: verify the recipientOne base lookup. Add-on properties are not required.
–
PHONE NUMBER0612345678
Country code required- Serving network
- Not looked up
- Issuing network
- Not looked up
- Base flag
No ported flag
Not looked upNot looked upRead the reported network context with the requested property.
Base responseE22000
error: "E22000"
reason: "International format required"Ask for the country code
A local number is not guessed into a country. Correct the input before attempting another lookup.
Next: confirm the full numberInvalid international format. No lookup charge.
Format deliberately.
Request what you need.
Understand a number’s format, line type and network context.
Use the base record first.
The base lookup returns serving and issuing networks, coarse line type and the number’s country where one applies. Non-geographic ranges may have no single country.
Retry the same purchase safely.
Use POST with an Idempotency-Key for automated lookups. Retrying the same request can replay the stored answer instead of buying another lookup; GET cannot carry that key.
Scale without
losing control.
Organize teams in workspaces, control API access, and trace changes through audit logs.
HarborOrganizationWorkspacesProductionSandbox
Delivery agent
API key · Customer operations teamALAlex Lee AdminPermissions updated
Audit log
Production- Workspace
- Production
- Resource
- Delivery agent
- Read accessRead & write
Team Customer operationsActor role AdminOutcome SucceededTime 22 Sep, 09:42:18 UTC
Succeeded