API de Códigos DDI

Acesso a dados completos de códigos DDI para suas aplicações

Base URL

https://country-code.com/api

Available Endpoints

GET

Get All Countries

/api/countries

Retrieve a complete list of all countries with their dialing codes, ISO codes, currencies, and basic information.

Response includes:

• Country name and ID
• International dialing code
• ISO2 and ISO3 country codes
• Currency information
• Timezone and region

GET

Get Country Details

/api/countries/:id

Get detailed information for a specific country including city codes and dialing instructions.

Includes everything above plus:

• Step-by-step dialing instructions
• City area codes
• International calling examples
• Flag image URL

Example API Response

{
  "id": "united-states",
  "name": "United States",
  "code": "+1",
  "iso": "US",
  "iso3": "USA",
  "region": "North America",
  "timezone": "UTC-5 to UTC-12",
  "currency": {
    "code": "USD",
    "name": "US Dollar",
    "symbol": "$"
  },
  "flag": "/flags/us.png",
  "example": "+1 212 555 1234",
  "dialingInstructions": {
    "international": "+1 XXX XXX XXXX",
    "steps": [
      "Dial your country's international access code",
      "Dial the US country code: 1",
      "Dial the area code and phone number"
    ]
  },
  "cityCodes": [
    { "city": "New York", "code": "+1 212" },
    { "city": "Los Angeles", "code": "+1 213" }
  ]
}

Coming Soon to Our API Platform

These powerful features are in development and will be available soon

Real-time Data

Live timezone information, current local time, and dynamic country data updates.

API Authentication

Secure API keys, rate limiting, and usage analytics for production applications.

Advanced Filtering

Filter countries by region, timezone, currency, or calling code patterns.

Mobile SDK

Native iOS and Android SDKs for seamless mobile app integration.

Webhooks

Real-time notifications for country data changes and updates.

GraphQL Support

Flexible GraphQL API for custom queries and efficient data fetching.

🚀 Full API Platform Coming Soon

Our comprehensive API platform with authentication, rate limiting, and advanced features is currently in development. The current endpoints are free to use for testing and development.

Current Usage Guidelines

Rate Limiting

Currently no rate limits are enforced. Please use responsibly and avoid excessive requests.

Data Freshness

Country data is updated regularly. All dialing codes and country information are verified for accuracy.

CORS Support

CORS is enabled for web applications. You can make requests directly from your frontend code.

Support

For questions or issues with the API, please contact us through our website.