Documentation

Company and address API

Connect your website to public data.

Get started

The API provides company and address suggestions and basic organization details. It reads locally stored regup records. Responses include their source and available freshness information.

The operator currently provisions pilot access. Self-service registration is not open yet.

Download OpenAPI →

https://api.regup.eu/v1

Endpoints

Request	Cost
`GET /v1/autocomplete/companies` Company suggestions	0.1 cr
`GET /v1/autocomplete/addresses` Address suggestions	0.1 cr
`GET /v1/companies/{country}/{ico}` Company or organization detail	1 cr
`POST /v1/browser-sessions` Create a short-lived browser session	No credits
`GET /v1/me/usage` Account usage	No credits

Successful details require the companies:read scope. The country is sk or cz and the company ID (IČO) must contain exactly eight digits, including leading zeroes.

Authentication

Send your server key in the Authorization header. Keep it on your server; never put it in JavaScript or URLs.

Authorization: Bearer <SERVER_API_KEY>

For a website, use the public project client ID and a short-lived browser session. The project must allow the exact HTTPS origin. The origin alone is not authentication.

Server example

Set REGUP_API_KEY to your issued server key in your own environment.

curl 'https://api.regup.eu/v1/companies/sk/55345662' \
  --header "Authorization: Bearer ${REGUP_API_KEY}" \
  --header 'Accept: application/json'

Credits and limits

The default free pilot includes 10,000 credits per calendar month, shared across all account projects and keys. Unused credits do not carry over.

Suggestions cost 0.1 credit per successful request. Basic details cost 1 credit. Selecting a suggestion needs no further request for the fields it already includes.

Responses use integer units: 10 units = 1 credit. X-Credits-Charged-Units reports the charged cost. Rate limits apply separately from the monthly allowance.

Responses and errors

Successful responses contain data and meta: request ID, cost, sources and available freshness information. Preserve attribution where required by the source terms. VAT bank accounts are excluded from the API.

400: Invalid parameters
401: Missing or invalid authentication
403: Missing permission or origin not allowed
404: Detail not found
409: Ambiguous organization identity
429: Rate or monthly limit reached
503: Service temporarily unavailable

Failed requests are not charged. When retrying after 429 or 503, respect Retry-After if present. If a connection fails after the server processes a successful response, the request may already have been charged.

JavaScript for forms

Attach the JavaScript libraries to your own form. The demos include script installation and handling the selected result.

Company demo →

Address demo →