Phone Numbers
List Phone Country Rules
List DialNexa phone country rules, calling codes, number lengths, and dialing prefixes for destination validation.
GET
List Phone Country Rules
Read only
List phone country rules to read the destination countries known to DialNexa. Each active rule includes the ISO country code, calling code, optional maximum number length, and configured prefixes.
When to list phone country rules
- Build a destination country selector.
- Normalize calling codes before submitting outbound numbers.
- Compare global country data with the network groups enabled for your workspace.
This operation returns the global country catalog. It does not mean every country or prefix is enabled for your workspace. Use List Enabled Network Groups for workspace-specific availability.
Verify the result
Match the destination’scountry_iso and calling_code. If prefixes is non-empty, use it as reference data only and still rely on the workspace-specific network group response before placing a call.
Errors and recovery
401 Unauthorizedmeans the API key is missing or invalid.- An empty array means no active country rules are currently available. Do not infer support from a stale local copy.
Related endpoints
- List Enabled Network Groups: read workspace-specific destination availability.
- List Phone Number Pricing: compare rental pricing by provider and country.
- Create Call: start an outbound call after validating the destination.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Response
Active phone country rules returned successfully.
List Phone Country Rules