Countries

Get a list of available countries for SMS reception.

Get Countries List

Retrieve all available countries with their codes.

Endpoint

GET /api/v1/numbers/countries/

Request

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/numbers/countries/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here'

Response

[
  {
    "code": "667",
    "name": "USA"
  },
  {
    "code": "187",
    "name": "USA (virtual)"
  },
  {
    "code": "51",
    "name": "Belarus"
  },
  {
    "code": "33",
    "name": "Colombia"
  }
]

Response Fields

Field	Type	Description
code	string	Country code to use in other endpoints
name	string	Country name

Important Notes

• USA Residential: USA residential numbers use code 667
• USA Virtual: USA virtual numbers use code 187
• Country codes should be passed to the /search/ endpoint in the country parameter
• Different country codes may have different pricing and availability

Country Types

Residential Numbers

Real mobile phone numbers with higher trust scores. Typically code 667 for USA.

Virtual Numbers

Virtual phone numbers that can receive SMS. May have different codes for the same country (e.g., code 187 for USA virtual).

Usage Example

import requests

headers = {
    'accept': 'application/json',
    'X-Api-Key': 'your_api_key_here'
}

response = requests.get(
    'https://app.cyberyozh.com/api/v1/numbers/countries/',
    headers=headers
)

countries = response.json()

# Find USA residential
usa_residential = next(c for c in countries if c['code'] == '667')
print(f"USA Residential: {usa_residential['name']} (code: {usa_residential['code']})")