# Doards Public API

Source page: https://doards.com/api

The Doards Public API provides free hosted access to business reference data for companies, developers, and product teams. The API is free to use, but it is not open source: Doards does not publish the source code, private repository, database exports, or internal maintenance process.

Access is provided through hosted API endpoints with an API key. Businesses can request an API key through the form on the Public API page.

## How Access Works

1. Request access through the API key form at https://doards.com/api.
2. Doards reviews the request and sends the API key, base URL, endpoint list, and usage notes by email.
3. Your application calls the hosted Doards endpoints with the API key.
4. Doards maintains the hosted reference data and updates it over time.

## Available Datasets

- Countries: country master data for onboarding, forms, routing, and business applications.
- States: state and region data connected to country and address workflows.
- Cities: city data for location-aware forms, directories, and operational systems.
- Industries: industry categories for CRM, lead intake, partner records, and analytics.
- Public holidays: holiday data for scheduling, booking, workforce, and planning tools.
- Car brands: vehicle brand data for fleet, rental, taxi, and logistics workflows.
- Peppol EAS: Electronic Address Scheme codes for e-invoice and accounting integrations.
- Peppol UNCL4461: payment means codes for structured billing and finance workflows.
- Kontenrahmen SKR03: incoming German chart of accounts reference data.
- Kontenrahmen SKR04: incoming German chart of accounts reference data.

## Peppol Codelists

The Public API includes Peppol reference data for e-invoicing workflows.

### Peppol EAS

- Endpoint: `/peppol_eas`
- Records: 81
- Fields: `id`, `code`, `description`
- Example item: `{"id":56,"code":"9930","description":"Germany VAT number"}`

Peppol EAS contains Electronic Address Scheme identifiers used to identify organizations and endpoints in Peppol and e-invoicing workflows.

### Peppol UNCL4461

- Endpoint: `/peppol_uncl4461`
- Records: 83
- Fields: `id`, `code`, `name`, `description`
- Example item: `{"id":58,"code":"58","name":"SEPA credit transfer","description":"Credit transfer inside the Single Euro Payment Area (SEPA) system."}`

Peppol UNCL4461 contains payment means codes used in structured invoices and accounting workflows, including SEPA credit transfer, SEPA direct debit, card, cheque, and other payment types.

## Common Use Cases

- Populate dropdowns and forms with maintained reference data.
- Validate invoice parties, payment means, addresses, and fleet data.
- Support CRM records, onboarding forms, imports, and operational dashboards.
- Reduce internal maintenance work for common business codelists.

## Important Notes

- The API is free to use with an API key.
- The service is hosted by Doards.
- Source code and internal datasets are not published.
- API key access helps Doards protect availability while keeping the data free.