registercheckby openlaw group
API referenceCompanies

List a company's tax IDs

GET
/companies/{company_id}/tax_ids

The USt-IdNr. and the Steuernummer the company prints on its own Impressum. A tax ID's type is one of Stripe's tax ID types: eu_vat for the USt-IdNr., de_stn for the Steuernummer. This is not register data.

  • Each tax ID was read from a page on the company's own website: provenance names the page (url) and when it was read (retrieved_at), never null.
  • The values are not checked with any tax authority (no VIES check). A USt-IdNr. is shown only when its check digit is valid.
  • The Steuernummer of a sole trader, a registered GbR, a partnership of professionals or an unclassified legal form identifies a natural person, and is never shown.
  • At most one tax ID of each type, eu_vat first. There is never a further page: next_cursor is always null.

When no tax ID can be shown, data is empty and the call is free. When what may be shown cannot be read right now, the request answers 503 with Retry-After, and nothing is charged. The same list is on the company with GET /companies/{company_id}?expand=tax_ids, at the company's price.

A company that was merged into another returns 301 with the surviving company's tax IDs in Location; the redirect is not charged.

Costs 10 credits, free when no tax ID can be shown.

Authorization

bearerAuth
AuthorizationBearer <token>

Your API key, sent as Authorization: Bearer rc_live_….

In: header

Path Parameters

company_id*string

The company's id (cmp_…). The raw UUID /v1 published before is still read until 2026-12-31, and such a request is answered with Deprecation and Sunset. An id of another kind, or anything else, answers 400 validation_failed naming company_id.

Match^cmp_[0-7][0-9a-hjkmnp-tv-z]{25}$

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://api.registercheck.de/v1/companies/cmp_01hxn3rys1fh58w4d1pb1x9s81/tax_ids" \  -H "Authorization: Bearer $REGISTERCHECK_API_KEY"

{  "object": "page",  "next_cursor": null,  "data": [    {      "object": "tax_id",      "type": "eu_vat",      "value": "DE136695976",      "country": "DE",      "provenance": {        "type": "web",        "url": "https://example.com/kontakt",        "retrieved_at": "2026-06-01T08:00:00Z"      }    },    {      "object": "tax_id",      "type": "de_stn",      "value": "143/168/20132",      "country": "DE",      "provenance": {        "type": "web",        "url": "https://example.com/impressum",        "retrieved_at": "2026-01-10T00:00:00Z"      }    }  ]}