Tool usage guide

Learn when to use this tool, what it supports, and how real users apply it.

Key facts

Category: Data Processing
Input types: text, select, checkbox, number
Output type: json
Sample coverage: 4
API ready: Yes

Overview

The ISO 3166 Country Code TLD and Subdivision Mapper looks up country and subdivision records from bundled local datasets. Enter a country name, ISO code, ccTLD, calling code, IOC code, UN M49 code, FIPS code, or ISO 3166-2 subdivision to receive structured JSON with matching code, timezone, and relationship data.

When to use

You need to convert a country name or code into ISO, ccTLD, calling, IOC, M49, or FIPS values.
You need to resolve an ISO 3166-2 subdivision and identify its parent country.
You want consistent country metadata from a local dataset without making network requests.

How it works

1Enter a query such as "US", "USA", ".us", "840", or "US-CA".
2Choose a search field, or leave Search Field set to Auto to let the mapper identify the query type.
3Enable Include Subdivisions when subdivision data should be included in the lookup.
4Set the result limit from 1 to 50, then receive the matching records as JSON.

Use cases

Build country reference tables with consistent ISO, domain, calling, sports, regional, and legacy code values.
Validate or enrich geographic data that contains mixed country identifiers such as USA, 840, .us, or US-CA.
Resolve administrative subdivisions and connect them to their parent country in data analysis workflows.

Examples

1. Inspect the United States code bundle

Data analyst

Background

A data analyst receives a dataset containing the value USA and needs the corresponding country identifiers for a reference table.

Problem

The country value must be mapped to ISO, ccTLD, calling, IOC, M49, FIPS, and timezone fields.

How to use

Enter `USA` in Query, keep Search Field set to `Auto`, leave Include Subdivisions disabled, and use the default result limit.

{"query":"USA","searchBy":"auto","includeSubdivisions":false,"limit":20}

Outcome

The tool returns a structured JSON country record with the matching code bundle and available timezone information.

2. Find the parent country for California

Geographic data manager

Background

A geographic data manager has an ISO 3166-2 code and needs to confirm which country owns the subdivision.

Problem

The code US-CA should be resolved as a subdivision rather than a general country query.

How to use

Enter `US-CA` in Query, choose `ISO 3166-2 subdivision` as Search Field, leave Include Subdivisions disabled, and keep the result limit at 20.

FAQ

Which query formats are supported?

You can search with country names, ISO alpha-2 or alpha-3 codes, ISO numeric codes, ccTLDs, ITU calling codes, IOC codes, UN M49 codes, FIPS codes, and ISO 3166-2 subdivision codes.

What does Auto search do?

Auto search selects the appropriate lookup behavior based on the value entered in the Query field.

Can I look up subdivisions such as US-CA?

Yes. Select ISO 3166-2 subdivision as the search field to resolve a subdivision and its parent country relationship.

What does the tool return?

The tool returns structured JSON country or subdivision records, including available code values and IANA timezone data.

Does the lookup require an internet connection?

No. The mapper uses bundled local datasets and does not make network requests.

{"query":"US-CA","searchBy":"subdivision","includeSubdivisions":false,"limit":20}

ISO 3166 Country Code TLD and Subdivision Mapper

What this tool helps you do

Run this tool

Examples that match this tool

Continue with connected tools and hubs

Learn when to use this tool, what it supports, and how real users apply it.

Key facts

Overview

When to use

How it works

Use cases

Examples

1. Inspect the United States code bundle

2. Find the parent country for California

FAQ

QR Code Samples

Code Comment Samples

Code Viewer Samples

Code Documentation Samples

Log Redactor

Foreign Key Validator

International Calling Code

Beam Deflection Calculator