GoDaddy Countries API

Name: GoDaddy Countries API API
Brand: GoDaddy Countries API
Availability: InStock

✓ Official Vendor SpecData EnrichmentData Transformationnone2 EndpointsREST

For Agents

Look up country metadata, calling codes, and state lists filtered by market for localization and international form validation.

Connect the GoDaddy Countries API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the GoDaddy Countries API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with GoDaddy Countries API API.

Retrieve summary country lists filtered by market ID with ISO codes and calling codes

Look up detailed country information including all states and provinces

Access localized country names based on market language preferences

Validate ISO country codes against supported country database

GET STARTED

Start building with GoDaddy Countries API API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use GoDaddy Countries API API for, with concrete tasks.

★ International Checkout Forms

Build localized checkout and registration forms with country and state dropdowns populated from GoDaddy's validated dataset. The API returns country names in the appropriate language based on market ID, ISO country codes for backend processing, and state/province lists for address validation. Supports BCP-47 market codes for 20+ languages.

Retrieve all countries for market 'en-US' and then fetch detailed state information for country code 'US' to populate a checkout address form

Phone Number Validation

Validate and format international phone numbers by looking up calling code prefixes for each country. The API provides the dialing prefix for every supported country, enabling real-time phone validation in user input forms and normalizing phone numbers to E.164 format before storage.

Look up the calling code for country 'GB' to validate a UK phone number format

Market-Specific Localization Testing

Test application behavior across different market locales by retrieving country data with localized labels. The OTE environment allows developers to verify that country names display correctly in each supported language before deploying to production. Essential for QA workflows on international SaaS platforms.

Compare country name localization by fetching the full country list for market 'fr-FR' and 'en-US' to verify French translations

AI Agent Address Validation

AI agents use this API through Jentic to validate user-provided addresses during automated workflows like order processing or account setup. By searching for country validation operations in Jentic, agents can verify ISO codes, retrieve state lists for data normalization, and localize country names without manual API integration. The no-auth design makes it ideal for agent-driven validation tasks.

Search Jentic for 'validate country and state data' to retrieve the GoDaddy Countries API schema, then call GET /v1/countries/{countryKey} with marketId to validate an address

Key Endpoints

2 endpoints — retrieve localized country information including iso codes, calling codes, and state/province data.

METHOD

PATH

DESCRIPTION

GET

/v1/countries

List all countries with summary information (ISO code, label, calling code) for a market

GET

/v1/countries/{countryKey}

Retrieve detailed country information including states and provinces for a specific country code

GET

/v1/countries

List all countries with summary information (ISO code, label, calling code) for a market

GET

/v1/countries/{countryKey}

Retrieve detailed country information including states and provinces for a specific country code

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The GoDaddy Countries API requires no authentication, so agents access it directly through Jentic's execution layer with no credential isolation needed. This simplifies agent configuration for workflows requiring country validation.

Intent-based discovery

Agents search by intent such as 'validate country code' or 'retrieve state list for a country'. Jentic returns the two GoDaddy Countries operations with their input schemas (marketId and countryKey parameters), allowing agents to select the correct endpoint without browsing documentation.

Time to first call

Direct GoDaddy Countries API integration: 1-2 hours to identify endpoints, read parameter docs, and build validation logic. Through Jentic: under 15 minutes—search for the validation intent, load the operation schema, and execute with validated parameters.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Country Layer API

Commercial country data API with richer metadata including currencies, languages, and regional information

Choose Country Layer when you need comprehensive country profiles beyond basic codes and states. Use GoDaddy Countries when you only need ISO codes, calling codes, and state lists for form validation.

Complementary

Country State City API

Extends country and state data with city-level information for three-tier address dropdowns

Use Country State City API when building forms that require city selection after country and state. GoDaddy Countries API stops at the state level.

Complementary

IP2Location API

Determines user country and location from IP address for auto-populating country fields

Combine with GoDaddy Countries API to automatically detect user country via IP geolocation, then use the detected country code to pre-select the country in forms and fetch the appropriate state list.

FAQs

Specific to using GoDaddy Countries API API through Jentic.

What authentication does the GoDaddy Countries API use?

None. The GoDaddy Countries API does not require authentication. It provides public access to country metadata, ISO codes, calling codes, and state lists. This is an OTE (test environment) endpoint designed for development and testing.

Can I retrieve state lists for specific countries with the GoDaddy Countries API?

Yes. Use GET /v1/countries/{countryKey} with a valid ISO country code and marketId query parameter. The response includes an array of states with their state keys and localized labels. For example, calling /v1/countries/US returns all US states and territories.

What are the rate limits for the GoDaddy Countries API?

Rate limit violations return HTTP 429 with a retryAfterSec field indicating the wait time before retrying. Specific rate limits are not documented in the OpenAPI spec. The OTE environment is designed for testing and may have different limits than production GoDaddy APIs.

How do I get localized country names with the GoDaddy Countries API through Jentic?

Search Jentic for 'retrieve localized country data' to find the GoDaddy Countries API operations. Load the schema for GET /v1/countries, then execute with a BCP-47 marketId parameter like 'fr-FR' or 'es-ES'. The API returns country labels localized to that market's language. Install via pip install jentic and sign up at https://app.jentic.com/sign-up.

What is the difference between the summary and detailed country endpoints?

GET /v1/countries returns summary data for all countries (countryKey, label, callingCode only). GET /v1/countries/{countryKey} returns detailed information for one country including the full states array with stateKey and label fields. Use the summary endpoint for dropdowns, and the detailed endpoint when you need state/province lists.

Is the GoDaddy OTE Countries API free?

Yes. This is a test environment endpoint (OTE = Operational Test Environment) provided by GoDaddy for developers building applications. It requires no authentication or payment. For production use, verify whether GoDaddy offers a production version of this API and check their pricing.

Can AI agents use the GoDaddy Countries API for address validation?

Yes. AI agents discover this API through Jentic by searching for intents like 'validate country code' or 'get state list'. Jentic returns the operation schemas, and agents call the endpoints directly. The no-auth design makes it particularly simple for agent integration. Common agent tasks include validating ISO codes, populating country dropdowns, and normalizing address data.