REST API

Clean JSON over HTTPS for software and pipelines. Base URL https://ironhathq.com/api/v1 · authenticate with x-api-key: ih_live_… (or Authorization: Bearer).

Endpoints

EndpointDescription
GET/search?country=AT&q={name}Search the register by company name. Returns matches with registration number, legal form, seat, address.
GET/company/AT/{fn}Registry profile for one company (e.g. fn = 33158m).
GET/company/AT/{fn}/financials?periods=2Structured balance-sheet figures parsed from the official annual-account filings — up to 5 fiscal years, current + prior year per period.
GET/company/AT/{fn}/filingsIndex of all filed annual accounts: balance-sheet date, filing date, format, download key.
GET/company/AT/{fn}/filings/{key}Download the original document (PDF or structured XML) by key from the filings index.
GET/vat?id=ATU12345678Validate an EU VAT ID via the official VIES service. Works for all member states.

Example

Request
curl -H "x-api-key: YOUR_API_KEY" \
  "https://ironhathq.com/api/v1/company/AT/598134i/financials?periods=1"
{
  "country": "AT",
  "id": "598134i",
  "source": "firmenbuch-hvd (BMJ, CC BY 4.0)",
  "licenseClass": "official_open",
  "periods": [{
    "balanceDate": "2024-12-31",
    "fiscalYear": { "from": "2024-01-01", "to": "2024-12-31" },
    "currency": "EUR",
    "balance": {
      "totalAssets": { "current": 977089.96, "previous": 505000 },
      "equity":      { "current": 402410.09, "previous": 318220 },
      "cash":        { "current": 141830.12, "previous":  96410 }
    }
  }]
}

Every response carries source and licenseClass (official_open · resale_grade · internal_enrichment) so you can trace data provenance.

Errors

StatusMeaning
401Missing or invalid API key.
429Monthly free limit (500 requests) reached — resets on the 1st.
400Bad request — unsupported country, unknown register number, malformed parameter. The body contains a human-readable error.

Versioning

The API is versioned in the path (/api/v1). Breaking changes only ever arrive as a new version; v1 responses may gain fields but never lose them.