Reference data.
Ready for the
product you ship.

City, region, coordinates, ASN, and network for any IPv4 or IPv6 address, plus country details and Tor exit and cloud or hosting flags. Call it without an IP to locate the calling device.

• GET /v1/ip
• GET /v1/ip/{ip}
• GET /v1/ip/{ip}/{field}

Not included: Postal code stays null for looked-up IPs. Time zone comes from the city coordinates. No VPN or residential proxy detection: is_hosting only covers published cloud ranges and known hosting networks.

{
  "ip": "8.8.8.8",
  "version": "IPv4",
  "city": "Mountain View",
  "region": "California",
  "country_code": "US",
  "country_name": "United States",
  "in_eu": false,
  "latitude": 37.422,
  "longitude": -122.085,
  "country_calling_code": "+1",
  "currency": "USD",
  "asn": "AS15169",
  "org": "Google LLC",
  "source": "db-ip",
  "is_tor": false,
  "is_hosting": false,
  "hosting_provider": null
}

ISO country profiles with capitals, currencies, languages, and calling codes. Turkey's 81 provinces and 973 districts use stable ids such as TR-34 and TR-34-KADIKOY.

• GET /v1/countries
• GET /v1/countries/{code}
• GET /v1/countries/{code}/divisions
• GET /v1/divisions/{id}
• GET /v1/divisions/{id}/children

Not included: Province and district lists cover Turkey only. No neighbourhoods (mahalle) or population statistics. Postal codes have their own endpoint.

Checks a number's format and returns E.164, national, and international forms with the line type. An invalid number still returns 200 with valid: false.

• POST /v1/phones/validate
• GET /v1/phones/codes

Not included: Format only. It does not check whether the line is active or who owns it.

Checks plate patterns for Turkey and several European countries. Turkish plates are matched to their province, 01 to 81.

• POST /v1/plates/validate
• GET /v1/plates/formats

Not included: Format only. No vehicle registry, owner, or insurance lookup.

Official exchange rates from the ECB (default), the Federal Reserve H.10, and the Turkish Central Bank with forex and banknote buy and sell prices. Convert amounts and look up past days.

• GET /v1/rates?source=ecb
• GET /v1/rates?source=fed
• GET /v1/rates?source=tcmb
• GET /v1/rates?date=2025-12-31
• GET /v1/rates/convert
• GET /v1/currencies

Not included: Daily official rates, not live market quotes or bank card rates. History is ECB and TCMB only, one day per call.

Great-circle kilometers between two coordinates, or between the geographic centers of two countries.

• POST /v1/geo/distance

Not included: Straight-line distance. No road routes or travel times.

Checks an IBAN's country length and mod-97 checksum, formats it in groups of four, and names the bank for Turkish IBANs.

• POST /v1/iban/validate

Not included: Checksum and length only. It does not confirm the account exists or who holds it.

Checks the check digits of a Turkish identity number (TCKN, 11 digits) or tax number (VKN, 10 digits).

• POST /v1/tr/identity/validate
• POST /v1/tr/tax-number/validate

Not included: Format only. No NVI or GİB registry lookup, so it cannot say the number belongs to a real person or company.

Places, administrative areas, and approximate coordinates for a postal code in about 120 countries. Full codes in Canada, Ireland, the Netherlands, and the UK match their leading part.

• GET /v1/postal-codes/{country}/{code}
• GET /v1/postal-codes

Not included: No street-level address lookup or place-name search. Coordinates are area centroids. AR, BR, CA, CL, CN, IE, MT, NL, and GB hold only part of each code.

Checks national ID, tax, and company numbers for 14 countries with their published check-digit rules: CPF and CNPJ (including the alphanumeric CNPJ), DNI, codice fiscale, SIRET, PESEL, BSN, Steuer-ID, GSTIN, ABA routing, SIN, ABN, CURP, TC kimlik, and more.

• POST /v1/validate/{country}/{type}
• GET /v1/validate

Not included: Algorithmic only. No government registry lookup, so it cannot say the number belongs to a real person or company. Aadhaar, US SSN, and Japan's My Number are not offered. Values are never stored or logged.

Parses a User-Agent string into browser, engine, operating system, device type, vendor and model, and flags crawlers and bots. Call GET to parse your own request, or POST any string.

• GET /v1/user-agent
• POST /v1/user-agent

Not included: Parses what the string says; it cannot see through spoofed or reduced User-Agent strings (Chrome freezes the OS version). No Client Hints. Strings are never stored or logged.

Turns a latitude and longitude into a country and its first-level division (state, province, region) worldwide, and into the district (ilçe) in Turkey.

• GET /v1/reverse?lat={lat}&lon={lon}

Not included: No street, city, or postal code. Districts are Turkey only. Borders are generalized at 1:10m, so points within about 1 km of a border or coast can resolve to the neighbour; points at sea return 404.

Checks the check digit of EAN-8, UPC-A, EAN-13, GTIN-14, ISBN-10 and ISBN-13 codes, detects the type, and converts between ISBN-10, ISBN-13 and GTIN-14.

• GET /v1/barcodes/validate?code={code}

Not included: Check digits only. No product or book database is queried, so a valid code does not prove the product exists.

Public holidays for a country and year, and business-day math that skips weekends and holidays. Turkey includes the half-day eves.

• GET /v1/holidays?country=TR&year=2026
• POST /v1/business-days

Not included: No regional bank holidays as closed days, no administrative leave (idari izin) added by decree, no company closures.

The IANA time zone, UTC offset, and local time for coordinates or a country.

• GET /v1/timezone?lat=41.01&lon=28.98
• GET /v1/timezone?country=TR

Not included: Borders are simplified, so points right at a zone border can be off. No historic offsets or date conversion.

Checks an address's syntax, looks up the domain's mail servers over DNS, and flags disposable domains and role addresses like info@.

• POST /v1/email/validate

Not included: No SMTP check, so it cannot tell whether the mailbox exists. No spam-trap or reputation data.

Asks the European Commission's VIES service whether an EU VAT number is active, with the company name and address when the country shares them.

• POST /v1/vat/validate

Not included: EU numbers only (plus XI for Northern Ireland). No UK, Swiss, Norwegian, or Turkish numbers. Returns 503 when VIES is down.