Skip to main content
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’s country_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 Unauthorized means 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.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Active phone country rules returned successfully.

id
string
required
Example:

"pcr_abc123xyz789"

country_iso
string
required
Required string length: 2
Example:

"IN"

country_name
string
required
Example:

"India"

calling_code
string
required
Example:

"91"

prefixes
string[]
required
Example:
is_deleted
boolean
required
Example:

false

max_length
integer | null
Example:

10