Skip to main content
GET
/
purchasePhoneNumbers
/
fetchCountries
curl -X GET "https://api.zudu.ai/purchasePhoneNumbers/fetchCountries" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \

{
  "TWILIO": {
    "US": "United States",
    "GB": "United Kingdom",
    "CA": "Canada",
    "AU": "Australia"
  },
  "PLIVO": {
    "US": "United States",
    "GB": "United Kingdom"
  }
Retrieve a list of countries where phone numbers are available for purchase from your configured providers. 
curl -X GET "https://api.zudu.ai/purchasePhoneNumbers/fetchCountries" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \

{
  "TWILIO": {
    "US": "United States",
    "GB": "United Kingdom",
    "CA": "Canada",
    "AU": "Australia"
  },
  "PLIVO": {
    "US": "United States",
    "GB": "United Kingdom"
  }

​
Headers

​
X-API-KEY
string
required
Your API key (format: sk_...)
​
X-API-SECRET
string
required
Your API secret (format: s3cr3t_...)

​
Response Structure

Response is organized by provider:
  • Provider (e.g., TWILIO, PLIVO): Top-level key
    • Country Code (e.g., US, GB): Two-letter ISO code
      • Country Name: Full country name

​
Response Fields

​
country_code
string
Two-letter ISO 3166-1 alpha-2 country codeExample: US, GB, CA
​
country_name
string
Full country nameExample: United States, United Kingdom

​
Notes

  • Country codes follow ISO 3166-1 alpha-2 standard
  • Different providers may support different countries
  • Use the country code with Fetch Available Numbers to search for numbers
  • Results are grouped by provider for easy comparison