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.

success
enum<boolean>
required
Available options:
true
error
enum<boolean>
required
Available options:
false
statusCode
integer
required
Example:

200

message
string
required
Example:

"Success"

data
object[]
required
timestamp
string<date-time>
required