English
Deutsch
English
Türkçe
Italiano
Français
Public API

Free Public API for business data

We want to move forward and help other businesses grow. That is why Doards provides a fully free Public API with practical reference data that companies can use in their own products, forms, workflows, and automations. The API is free to use, but it is not open source: access is provided through hosted endpoints with an API key, not by publishing our source code or internal data repository.

Request API key View datasets
Doards Public API

What you get and how access works

The Public API gives your application hosted reference data. You request an API key, call the endpoints from your own system, and keep the source code and internal datasets on our side.

Where to get access

Use the API key form on this page. After we review the request, we send the API key, base URL, endpoint list, and usage notes to your email address.

How it works

Your application sends authenticated requests to Doards endpoints. Responses are structured for direct use in forms, validation, dropdowns, imports, CRM records, invoice workflows, and operational tools.

1. Request access

Fill out the API key form on this page and tell us which datasets you want to use.

2. We send the key

After review, we send your API key and endpoint details to the email address you provide.

3. Call the hosted API

Your system calls Doards endpoints with the API key. You receive structured data such as codes, names, descriptions, and related metadata.

4. We maintain the data

You do not need to copy files or maintain your own code tables. We keep the hosted reference data available and update it over time.

Included API datasets

Use clean, reusable data sets without licensing cost. Available datasets are served through API key access. SKR03 and SKR04 endpoints are currently disabled pending rights review.

Core data

7 endpoints
  • Countries
    • /countries Countries with ISO codes and currencies
    Country master data with ISO2/ISO3 codes, currency and phone code; the key most other datasets link to.
  • States
    • /states States and regions per country
    States and regions; filter by country (id, ISO2, ISO3 or name).
  • Cities
    • /cities Cities with coordinates
    Cities with coordinates; filter by state (id or name) to link them to states and countries.
  • Industries
    • /industries Industry and sector list
    Industry and sector list with group names for CRM and lead forms.
  • Public Holidays
    • /public-holidays Public holidays per country
    Public holidays per country (ISO2, required), optionally per state.
  • Car Brands
    • /car-brands Car manufacturers with logos
    Vehicle manufacturers with descriptions and logos.
  • Tire sizes
    • /tire-sizes Standard tire size designations
    Standard tire-size designations, searchable by text.

E-invoicing & finance

23 endpoints
  • Peppol EAS
    • /peppol-eas E-invoice address scheme codes
    81 Electronic Address Scheme codes (id, code, description) to identify e-invoice parties.
  • Peppol UNCL4461
    • /peppol-uncl4461 Payment means codes for invoices
    83 payment means codes (id, code, name, description); look up by code name with /by-name/{name}.
  • Exchange rates
    • /exchange-rates ECB euro rates, history and conversion
    ECB euro reference rates since 1999 (information only) with history and conversion; query by date and currency (ISO 4217).
  • Currency precision
    • /currency-precision Decimal digits per currency
    Decimal digits and rounding per currency; keyed by the ISO 4217 code, which matches the currency of /countries.
  • Kontenrahmen SKR03 Unavailable
    German chart of accounts reference data for SKR03 accounting workflows.
  • Kontenrahmen SKR04 Unavailable
    German chart of accounts reference data for SKR04 accounting workflows.
  • Business & legal references
    • /legal-forms Company legal forms per country
    • /registration-authorities Business register authorities
    • /courts German courts with their IDs
    Company legal forms and the authorities and courts that maintain business registers.
  • Tax references
    • /tax-offices German tax offices
    • /vat-rates EU VAT rates per country
    • /vat-rate-goods Reduced VAT rates by goods
    • /vat-number-formats VAT number formats per country
    • /special-tax-territories Territories outside the EU VAT area
    • /asset-useful-lives German asset depreciation periods
    Tax offices, VAT rates and formats, special tax territories, and German depreciation periods.
  • Invoicing & logistics codes
    • /incoterms Incoterms 2020 trade terms
    • /einvoicing-code-lists Peppol e-invoicing code lists
    • /peppol-participants Look up Peppol participant IDs
    • /units-of-measure UN/ECE unit of measure codes
    • /package-types UN/ECE packaging type codes
    • /euro-conversion-rates Fixed euro rates of old currencies
    • /nature-of-transaction-codes Intrastat nature of transaction codes
    • /gs1-application-identifiers GS1 barcode data identifiers
    • /barcode-symbologies Barcode types and formats
    • /einvoice-profiles E-invoice format IDs (XRechnung, Factur-X)
    Standard codes for invoices, trade, shipping, units, packaging, and product identifiers.

Addresses & places

21 endpoints
  • Postal codes
    • /postal-codes Postal codes with places and coordinates
    About 1.8 million postal codes with place names and estimated coordinates; link via country (ISO2).
  • Postal code localities
    • /postal-code-localities Localities with all their postal codes
    Localities of a country with every postal code that serves them; country (ISO2) is required.
  • Postal code formats
    • /postal-code-patterns Postal code format per country
    Postal code regex and example per country; look up by ISO2 country.
  • Address rules
    • /address-field-rules Address layout rules per country
    Address layout, required fields and naming per country; look up by ISO2 country.
  • City aliases
    • /city-aliases Alternative and historic city names
    Translated, abbreviated and historic city names (München → Munich); list all aliases of a place by its GeoNames id.
  • Municipalities
    • /municipalities Municipalities with population figures
    Third- to fifth-order administrative divisions with population; filter by country and admin1.
  • Administrative districts
    • /administrative-districts Districts, counties and provinces
    Second-order divisions (districts, counties, provinces); same country and admin1 filters.
  • Named places
    • /named-places Places, stations, airports and landmarks
    • /geographic-feature-types Explains the named place codes
    Populated places, stations, airports, ports and landmarks; detail by GeoNames id, codes explained by /geographic-feature-types.
  • UN/LOCODE
    • /un-locodes UN/LOCODE trade and transport locations
    Trade and transport locations with UN/LOCODE; filter by code or country.
  • EU municipalities (LAU)
    • /lau-units Official EU local administrative units
    Official EU local units with codes such as the German AGS and population; link to NUTS via nuts3.
  • ISO 3166-2
    • /iso3166-subdivisions ISO 3166-2 subdivision codes
    Subdivision codes with hierarchy; filter by country or parent.
  • Country facts
    • /country-capitals Capital city per country
    • /country-tlds Internet domain per country
    • /country-driving-side Left- or right-hand traffic
    Capital, top-level domain and driving side per country, all keyed by country (ISO2).
  • Country reference data
    • /country-neighbours Neighbouring countries
    • /country-groups EU, Schengen and EEA membership
    • /country-group-memberships Groups a country belongs to
    • /country-codes Country codes in several systems
    • /national-municipalities Municipality registers of DE, AT and CH
    Neighbouring countries, memberships, national codes and municipality codes.
  • Postal code links
    • /postal-code-nuts Postal code to NUTS region
    Links postal codes to EU NUTS statistical regions.

Maps & boundaries

3 endpoints
  • Boundaries
    • /country-boundaries Country outlines as GeoJSON
    • /state-boundaries State outlines as GeoJSON
    • /urban-areas Urban area outlines for a map area
    Generalized GeoJSON polygons for countries, states and urban areas; filter by country or bbox, add include_geometry for shapes.

Time zones

4 endpoints
  • Time zones
    • /timezones IANA time zone identifiers
    • /country-timezones Time zones used per country
    IANA time zone ids and the zones each country uses; join countries to zones via ISO2 and tz_id.
  • Time zone changes
    • /timezone-transitions DST and offset changes 1970-2037
    • /timezone-rules/{tz_id} POSIX rule for dates after 2037
    DST and offset changes from 1970 to 2037 for a tz_id, plus the POSIX rule afterwards.

Aviation & transport

58 endpoints
  • Airports
    • /airports Airports with IATA and ICAO codes
    About 86,000 airports with IATA and ICAO codes; look up by ICAO, IATA or ident, filter by country.
  • Runways, frequencies, navaids
    • /airport-runways Runways per airport
    • /airport-frequencies Radio frequencies per airport
    • /navigation-aids Radio navigation aids
    Per-airport details, not for flight operations; filter by airport (ICAO or IATA) or use /airports/{code}/runways.
  • Stations & ports
    • /railway-stations Railway stations, searchable by location
    • /metro-tram-stations Metro and tram stations
    • /ferry-terminals Ferry terminals
    • /seaports Seaports
    Railway, metro and tram stations, ferry terminals and seaports from Wikidata; search by country or near=lat,lon.
  • Vehicle reference codes
    • /vehicle-makes Vehicle makes (U.S. market)
    • /vehicle-manufacturers Vehicle manufacturers (U.S. market)
    • /vehicle-models Models per make (U.S. market)
    • /vehicle-wmi-codes VIN manufacturer prefixes (WMI)
    • /vehicle-recalls Vehicle recall campaigns (U.S.)
    • /vehicle-model-years Recalled model years per model
    • /vehicle-co2-models EU new cars with CO2 values
    • /vehicle-fuel-types Fuel types of EU new cars
    • /kba-vehicle-types German vehicle types by HSN and TSN
    • /kba-manufacturers German manufacturer keys (HSN)
    • /vehicle-code-lists German vehicle class, body and fuel codes
    • /license-plate-regions German licence plate prefixes
    • /driving-licence-codes EU driving licence codes
    • /tyre-label-classes EU tyre label classes
    • /ev-connector-types EV charging connector types
    • /euro-emission-limits Euro emission standard limits
    • /vehicle-weights-dimensions Legal vehicle weights and dimensions
    • /driving-time-rules Driving and rest time rules
    • /vin-character-tables VIN character and check digit tables
    Vehicle makes, models, registrations, recalls, emissions, and German vehicle and licence codes.
  • Legal and accounting references
    • /financial-statement-lines Financial statement line items
    • /operating-cost-types Operating cost categories
    • /invoice-required-particulars Mandatory invoice details by type
    • /vat-special-provisions VAT exemptions and reverse charge
    • /record-retention-periods Record retention periods by law
    • /statutory-notice-periods Statutory notice periods
    • /labour-law-minimums Minimum labour law standards
    • /energy-performance-classes Building energy efficiency classes
    Business reporting codes and selected statutory tax, accounting, workplace and building references.
  • Hospitality & product data
    • /food-allergens EU food allergen list
    • /food-additives Food additives with E numbers
    • /meal-plan-codes Hotel meal plan codes
    • /clp-statements/{kind} Hazard and precautionary statements
    • /clp-pictograms GHS hazard pictograms
    • /eu-waste-codes EU waste classification codes
    • /waste-treatment-operations Waste treatment operation codes
    • /waste-hazard-properties Hazardous waste properties
    • /weee-categories Electronic waste (WEEE) categories
    • /textile-fibre-names Textile fibre names
    • /reference-intakes Nutrition reference intakes
    • /nutrition-claims Permitted nutrition claims
    Food and nutrition references, chemical hazard labels, waste codes, and product compliance data.
  • Developer references
    • /media-types MIME media types
    • /file-extensions File extensions and their media type
    • /language-subtags BCP 47 language subtags
    • /http-status-codes HTTP status codes
    • /uri-schemes Registered URI schemes
    • /service-ports Network service port numbers
    • /character-sets Character sets and aliases
    • /smtp-status-codes SMTP reply status codes
    • /unicode-blocks Unicode character blocks
    • /short-number-patterns Short and emergency numbers
    • /paper-sizes Paper sizes such as A4
    IANA, Unicode and other technical registries for validation, file handling and integrations.

Classifications

16 endpoints
  • NACE
    • /nace-codes NACE economic activity codes
    • /nace-correspondences Mapping between NACE editions
    EU activity classification Rev. 2 and 2.1 with hierarchy in English and German; pick the edition with revision.
  • CPA
    • /cpa-codes CPA product classification codes
    EU product classification 2008, 2.1 and 2.2 with hierarchy; pick the version with version.
  • CPV
    • /cpv-codes Public procurement CPV codes
    EU Common Procurement Vocabulary with the official hierarchy in English and German; look up by code.
  • PRODCOM & Combined Nomenclature
    • /prodcom-codes PRODCOM production list codes
    • /cn-codes Customs tariff (CN) codes
    EU production list and customs tariff nomenclature with hierarchy; pick the edition with year.
  • NUTS
    • /nuts-codes NUTS statistical regions
    EU statistical regions NUTS 1–3 by version; the NUTS 3 code links to /lau-units.
  • WZ
    • /wz-codes German WZ activity classification
    • /wz-correspondences Mapping between WZ and NACE
    German economic-activity classification WZ by edition; map to NACE with /wz-correspondences.
  • Additional classifications
    • /oenace-codes Austrian ÖNACE activity codes
    • /classifications List of other classification schemes
    • /classifications/{scheme} Codes of one classification scheme
    • /proficiency-levels/{scale} EQF and CEFR proficiency levels
    • /eurovoc EuroVoc multilingual thesaurus
    • /nace-explanatory-notes Official NACE explanatory notes
    • /nace-isic-correspondences Mapping between NACE and ISIC
    ÖNACE, EuroVoc and other EU classification schemes, with code descriptions and cross-references.

Localization & phone

38 endpoints
  • Locales & languages
    • /locales Unicode CLDR locales
    • /languages List of languages
    • /writing-scripts Writing scripts such as Latin
    • /locale-aliases Alternative locale identifiers
    • /territory-languages Languages spoken per territory
    Unicode CLDR locales, languages and scripts; inheritance such as de-AT → de → root is resolved by the API.
  • Translations
    • /language-translations Language names in any locale
    • /region-translations Country names in any locale
    • /currency-translations Currency names in any locale
    • /subdivision-translations Subdivision names in any locale
    Localized names of languages, countries, currencies and subdivisions; pass the locale.
  • Formats & units
    • /number-formats Number formats per locale
    • /date-time-formats Date and time formats
    • /currency-symbols Currency symbols per locale
    • /week-rules Week start, weekend and numbering
    • /measurement-systems Metric or imperial per territory
    Number, date and currency formats, week rules and measurement systems per locale or territory.
  • World regions & currencies
    • /un-m49-regions UN continents and sub-regions
    • /currency-territories Which territories use which currency
    UN M49 continents and sub-regions with their countries, plus which territories use which currency.
  • Phone numbers
    • /phone-validation-patterns Phone number validation patterns
    • /phone-number-formats Phone number formatting rules
    • /phone-prefix-regions Region descriptions for phone prefixes
    Phone number patterns, formats and area descriptions per region; look up a number with /phone-prefix-regions/lookup.
  • More locale data
    • /calendar-names Month and weekday names
    • /plural-rules Plural rules per language
    • /unit-conversions Unit conversion factors
    • /unit-preferences Preferred units per region
    • /list-patterns List patterns like A, B and C
    • /relative-time-fields Relative time wording, e.g. yesterday
    • /date-interval-formats Date range formats
    • /compact-number-formats Short numbers like 1K or 1M
    • /person-name-patterns Person name formatting patterns
    • /person-name-settings Person name order settings
    • /exemplar-characters Typical characters of a language
    • /quotation-marks Quotation marks per locale
    • /windows-timezone-map Windows to IANA time zones
    • /likely-subtags Complete partial locale codes
    • /calendar-eras Calendar era names
    • /numbering-systems Numbering systems and digits
    • /hour-cycle-preferences 12- or 24-hour clock
    • /emoji-annotations Emoji names and keywords
    • /emoji-groups Emoji groups and subgroups
    Calendar, number, list, name, time-zone and emoji conventions by locale or territory.

Licences & sources

1 endpoint
  • Data sources
    • /data-sources Source and licence per dataset
    Source, licence, attribution and loaded snapshot of every dataset; query by dataset name.

Built to help teams move faster

The Public API is made for companies that need reliable business reference data without building and maintaining every list themselves.

  • Free API access for business and development use cases.

  • Useful for onboarding forms, directories, CRM records, accounting tools, scheduling, fleet systems, and custom dashboards.

  • API key access helps us protect availability while keeping the data free.

Request your API key

Fill out the form and tell us how you want to use the Public API. We will review the request and send the API key to your email address.

Name

E-mail address

Company

Website or product

Datasets

Select the datasets you are interested in:

Use case

We are committed to your privacy. By clicking Send, you accept our privacy policy. Doards uses your information to contact you about API access and related services. For more information, please see our Privacy policy.