---
title: "How to use Country Calling Codes"
url: "https://lookvalid.com/help/products/country-code.md"
canonical_url: "https://lookvalid.com/help/products/country-code"
last_updated: "2026-10-22"
type: "how-to"
summary: "What Country Calling Codes takes in, which fields it returns and how credits are charged for each lookup."
related: ["https://lookvalid.com/help/products/phone.md", "https://lookvalid.com/help/products/email-domain-check.md", "https://lookvalid.com/help/products/ip.md", "https://lookvalid.com/help/billing/plans-and-credits.md"]
---

# How to use Country Calling Codes

What Country Calling Codes takes in, which fields it returns and how credits are charged for each lookup.

## What it does

Looks up a country by calling code (+44), ISO region (GB) or English country name and returns the calling code, every region that shares it, national number lengths, trunk and international dialing prefixes, example numbers and the leading digits of mobile and fixed-line numbers where the numbering plan defines them. Derived from open libphonenumber metadata and CLDR country names; it describes numbering-plan rules, not who is assigned a number.

## What you send

Send these fields in the JSON body of the request.

Request fields for Country Calling Codes

| Field | Type | Required | Limits |
| --- | --- | --- | --- |
| query | string | Required | up to 64 characters |

## What it costs

1 credit per lookup (an unknown code, country or name is free).

What each outcome costs

| Case | Charge |
| --- | --- |
| Found | 1 credit |
| Nothing found | 0 credits |
| Repeat inside 7 days | 0 credits |
| Errors and invalid requests | 0 credits |

## Run it

You can try it without an account in the [free tool](https://lookvalid.com/tools.md). The free tools share a limit per visitor.

From code, send a POST request to `https://YOUR_API_HOST/v1/country-code` with your API key.

A request to Country Calling Codes

```bash
curl -X POST https://YOUR_API_HOST/v1/country-code \
  -H "Authorization: Bearer $LOOKVALID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"+44"}'
```

Full parameters and response fields are in the [API reference](https://lookvalid.com/docs/api/country-code.md). To run a list of values, use a [bulk CSV job](https://lookvalid.com/help/api/bulk-csv-jobs.md).

## Good to know

- A repeat of the same lookup within 7 days is served from your cache and costs 0 credits.
- When the lookup finds nothing it returns `found: false` and costs 0 credits.
- Invalid input and errors are never charged.
- The API allows 200 requests per 10 seconds per key.

## Related

- [How to use Phone Numbering-Plan Validation](https://lookvalid.com/help/products/phone.md)
- [How to use Email Domain Check](https://lookvalid.com/help/products/email-domain-check.md)
- [How to use IP Intelligence](https://lookvalid.com/help/products/ip.md)
- [Plans, credits and how they are spent](https://lookvalid.com/help/billing/plans-and-credits.md)