# LiveAPI

> LiveAPI (https://liveapi.io) is a REST API with one bearer token for IP geolocation (city, region, coordinates, ASN for any IPv4/IPv6, with Tor exit and cloud/hosting flags), reverse geocoding to country and state (district in Turkey), User-Agent parsing with bot detection, country profiles, postal codes in about 120 countries, phone, license plate, IBAN, email and EU VAT (VIES) validation, national ID, tax and company number checks for 14 countries (Turkey, Brazil, Spain, Italy, France, Poland, the Netherlands, Belgium, Germany, India, the US, Canada, Australia and Mexico), Turkey's 81 provinces and 973 districts, official exchange rates from the ECB, the Federal Reserve and the Turkish Central Bank (TCMB), public holidays and business days, time zones and distance. It also runs a remote MCP server at https://liveapi.io/mcp for AI assistants.

Base URL: https://liveapi.io. Authentication: `Authorization: Bearer YOUR_TOKEN` (get a token by signing in at https://liveapi.io/login with an email code). Responses are JSON. Free: 100 calls for every new account. Packs (one-time, never expire): 10,000 calls $5, 100,000 calls $15, 250,000 calls $29. Unlimited: $39/month, cancel anytime. Only successful 2xx responses use a call; errors are free.

## Docs

- [OpenAPI 3 spec](https://liveapi.io/openapi.json): machine-readable description of every endpoint
- [Docs](https://liveapi.io/docs): every endpoint, with samples in cURL, TypeScript, PHP, Go, Rust, and .NET
- [Full LLM context](https://liveapi.io/llms-full.txt): every API with endpoints, examples and limits in one file
- [MCP server](https://liveapi.io/mcp-server): connect Claude, ChatGPT, Cursor and other MCP clients to https://liveapi.io/mcp
- [Integrations](https://liveapi.io/integrations): call the API from cURL, JavaScript, Python, PHP, Go, n8n, Zapier or Make with a bearer token, and MCP setup for Claude and Cursor
- [Pricing](https://liveapi.io/pricing): Free: 100 calls for every new account. Packs (one-time, never expire): 10,000 calls $5, 100,000 calls $15, 250,000 calls $29. Unlimited: $39/month, cancel anytime. Only successful 2xx responses use a call; errors are free.

## APIs

- [IP geolocation API](https://liveapi.io/apis/ip-geolocation): IP geolocation API that returns city, region, country, coordinates, ASN and network for any IPv4 or IPv6 address. DB-IP data, JSON over HTTPS, 100 free calls.
- [Countries API](https://liveapi.io/apis/countries): REST countries API with ISO 3166 codes, capitals, currencies, languages and calling codes for every country, plus Turkey's provinces and districts. JSON, 100 free calls.
- [Phone validation API](https://liveapi.io/apis/phone-validation): Validate and format phone numbers for any country. Get E.164, national and international formats and line type (mobile, fixed line) as JSON. 100 free calls.
- [Exchange rates API](https://liveapi.io/apis/exchange-rates): Official daily exchange rates from the ECB, the Federal Reserve H.10 and the Turkish Central Bank (TCMB). Convert amounts and fetch past days. JSON, 100 free calls.
- [Distance API](https://liveapi.io/apis/distance): Calculate great-circle (haversine) distance in kilometers between two coordinates or two countries' centers with one JSON call. 100 free calls.
- [Public holidays API](https://liveapi.io/apis/public-holidays): Public holidays for any country and year, plus business-day math that skips weekends and holidays. Turkey includes half-day eves (arife). JSON, 100 free calls.
- [Time zone API](https://liveapi.io/apis/time-zones): Get the IANA time zone, UTC offset, DST flag and local time for coordinates or a country. JSON over HTTPS, 100 free calls.
- [Email validation API](https://liveapi.io/apis/email-validation): Validate email addresses: syntax, DNS MX lookup, disposable-domain and role-address detection. No SMTP probing. JSON, 100 free calls.
- [EU VAT validation API](https://liveapi.io/apis/eu-vat-validation): Check EU VAT numbers against the European Commission's VIES service and get the company name and address when available. Clean JSON, 100 free calls.
- [Postal code API](https://liveapi.io/apis/postal-codes): Look up a postal code, ZIP or postcode and get place names, administrative areas and coordinates from LiveAPI's in-house dataset. JSON, 100 free calls.
- [National ID validation API](https://liveapi.io/apis/id-validation): Validate ABN, Belgian national numbers, CPF, CNPJ, SIN, SIRET, Steuer-ID, GSTIN, codice fiscale, CURP, RFC, BSN, PESEL, DNI, NIE, TC kimlik and ABA routing numbers with official check-digit rules.
- [Tor and data center IP detection](https://liveapi.io/apis/ip-risk-flags): Check whether an IP is a Tor exit node or belongs to AWS, Google Cloud, Azure, Cloudflare, Oracle, DigitalOcean, Hetzner, OVHcloud and other hosting networks. Part of every /v1/ip response.
- [User agent parser API](https://liveapi.io/apis/user-agent-parser): Parse any User-Agent string into browser, engine, OS, device type, vendor and model, with crawler and bot detection. GET parses your own request; POST parses any string.
- [Reverse geocoding API](https://liveapi.io/apis/reverse-geocoding): Turn latitude and longitude into a country and state or province worldwide, and into the district (ilçe) in Turkey. Point-in-polygon on Natural Earth and OpenStreetMap boundaries.
- [Barcode and ISBN validation API](https://liveapi.io/apis/barcode-validation): Validate EAN-8, EAN-13, UPC-A, GTIN-14, ISBN-10 and ISBN-13 check digits, detect the barcode type, and convert ISBN-10 to ISBN-13 and GTIN-14. Algorithmic, nothing stored.

## Regional APIs

- [Regional APIs overview](https://liveapi.io/apis/regional): country-specific ID checks, postal codes, holidays, IBAN and VAT
- [Australia APIs](https://liveapi.io/apis/regional/australia): ABN and TFN checks, 18,000+ postcodes with state, and holidays.
- [Belgium APIs](https://liveapi.io/apis/regional/belgium): National register and BIS number checks with birth date and sex, postal codes, holidays, IBAN and VIES.
- [Brazil APIs](https://liveapi.io/apis/regional/brazil): CPF and CNPJ checks, including the alphanumeric CNPJ that Receita Federal issues from July 2026, plus postal codes, holidays and IBAN.
- [Canada APIs](https://liveapi.io/apis/regional/canada): SIN checks with the issuing region, forward sortation areas, and holidays.
- [France APIs](https://liveapi.io/apis/regional/france): SIREN, SIRET and NIR checks (including La Poste SIRETs and Corsican NIRs), postal codes, holidays, IBAN and VIES.
- [Germany APIs](https://liveapi.io/apis/regional/germany): Steuer-ID and USt-IdNr checks, postal codes, state holidays, IBAN, plates and VIES.
- [India APIs](https://liveapi.io/apis/regional/india): PAN format checks and GSTIN checksum checks, plus 155,000+ PIN codes with state and district.
- [Italy APIs](https://liveapi.io/apis/regional/italy): Codice fiscale checks that decode birth date and sex (including omocodia), partita IVA checks, postal codes, holidays, IBAN and VIES.
- [Mexico APIs](https://liveapi.io/apis/regional/mexico): CURP checks with birth date, sex and state, RFC checks for people and companies, 144,000+ postal codes and holidays.
- [Netherlands APIs](https://liveapi.io/apis/regional/netherlands): BSN checks with the 11-proof, 4-digit postal areas, holidays, IBAN and VIES.
- [Poland APIs](https://liveapi.io/apis/regional/poland): PESEL checks with birth date and sex, NIP and REGON checks, postal codes, holidays, IBAN and VIES.
- [Spain APIs](https://liveapi.io/apis/regional/spain): DNI, NIE and CIF checks with their control letters, postal codes for every province, holidays, IBAN and live VIES VAT checks.
- [Turkey APIs](https://liveapi.io/apis/regional/turkey): The deepest regional coverage in LiveAPI: 81 provinces and 973 districts, TC kimlik and VKN checks, Turkish IBAN bank names, plates matched to provinces, TCMB rates, and holidays with half-day eves.
- [United States APIs](https://liveapi.io/apis/regional/united-states): ABA routing number and EIN checks, 41,000+ ZIP codes with state and county, federal holidays and Federal Reserve H.10 rates.
- [Turkey provinces & districts API](https://liveapi.io/apis/turkey-provinces-districts): API for all 81 Turkish provinces (il) and 973 districts (ilçe) with stable ids like TR-34 and TR-34-KADIKOY. Build address forms with JSON. 100 free calls.
- [Turkish license plate API](https://liveapi.io/apis/turkish-license-plates): Validate Turkish license plates and match them to their province (01–81), plus plate patterns for several European countries. Format check only, JSON. 100 free calls.
- [TCMB exchange rates API](https://liveapi.io/apis/tcmb-exchange-rates): Turkish Central Bank (TCMB) daily exchange rates as JSON: forex and banknote buying and selling prices, historical days and conversion. No XML parsing. 100 free calls.
- [IBAN validation API](https://liveapi.io/apis/iban-validation): Validate IBANs with country length and mod-97 checksum, format them in groups of four, and get the bank name for Turkish (TR) IBANs. JSON, 100 free calls.
- [TC kimlik & VKN validation API](https://liveapi.io/apis/tc-kimlik-vkn-validation): Validate Turkish identity numbers (TCKN, 11 digits) and tax numbers (VKN, 10 digits) with the official checksum algorithms. Numbers are never logged. 100 free calls.

## Optional

- [About](https://liveapi.io/about): what LiveAPI is, its open-data rules, and how it is built and run by AI agents
- [Terms](https://liveapi.io/terms)
- [Privacy](https://liveapi.io/privacy)
- [Support](https://liveapi.io/support): info@liveapi.io