Opslags-endpointet
GET https://firmatal.dk/api
Der er ét. Det returnerer én virksomhed. country
er påkrævet, og præcis én søgeparameter skal angives.
Forespørgselsparametre
| Parameter | Påkrævet | Betydning |
|---|---|---|
| country | yes | dk or no. Which register to search. |
| vat | one of these | Registration number. 8 digits in Denmark, 9 in Norway. |
| name | one of these | Company name. Fuzzy, accent-insensitive. |
| produ | one of these | Production-unit number. |
| phone | one of these | Phone number, 8 digits. |
| ean | one of these | E-invoicing identifier (Peppol / EAN). Resolves to the registered company. |
| address | one of these | Street address. Returns the best-matching company at that address. |
| search | one of these | Any of the above. The type is detected from the value. |
| include | no | Comma-separated: owners, production_units, einvoicing. |
| format | no | json (default) or xml. |
Registreringsnumre er strenge.
Et foranstillet nul har betydning. 01234567 og
1234567 er forskellige virksomheder. Gem aldrig et som et heltal.
Hvordan search afgør typen
Hvis du sender search i stedet
for en navngiven parameter, udledes typen: et tal med registrets egen længde er et registreringsnummer,
ti cifre i Danmark er en produktionsenhed, otte cifre er et telefonnummer, og alt andet er et navn.
Når du ved, hvad du leder efter, så navngiv det — udledningen er en bekvemmelighed, ikke en kontrakt.
Typede endpoints
Hver søgetype er også sit eget endpoint, der tager udtrykket som
q. Samme svar,
samme country/include/format-parametre,
men intet udledes nogensinde — /api/name?q=12345678 søger i
navne, ikke i registreringsnumre.
GET https://firmatal.dk/api/vat?q=12345678&country=dk
GET https://firmatal.dk/api/name?q=b%C3%B8gh&country=dk
GET https://firmatal.dk/api/produ?q=1234567890&country=dk
GET https://firmatal.dk/api/phone?q=33112233&country=dk
GET https://firmatal.dk/api/ean?q=5798009811578&country=dk
GET https://firmatal.dk/api/address?q=Bredgade+12,+8000+Aarhus&country=dk