Skip to content
Accquix Register
Esc
↑↓navigate↵open⌘Jpreview

Look up up to 100 identifiers

fields=versions returns only the section versions, for daily change checks.

POST/v1/lookup:batch
Authorization
AuthorizationBearer token · headerrequired
Request body
requiredapplication/json
fieldsstring

versions returns only each section's state and version

default: "all"
Allowed:allversions
idsstring[] | nullrequired
min items 1 · max items 100
Responses
200

OK

attributionstring[] | nullrequired
itemsBatchItem[] | nullrequired
Show properties
Array of BatchItem
codestring
idstringrequired
resultLookupBody
Show properties
attributionstring[] | nullrequired
subjectsSubject[] | nullrequired

One subject; several for a VAT group (IČ DPH)

Show properties
Array of Subject
icostring
identityIdentityrequired
Show properties
activeboolean
addressAddress
Show properties
buildingNumberstring
countrystring
municipalitystring
postalCodestring
streetstring
establishedOnstring
icoChecksumValidboolean

The IČO check digit; a warning only, real IČOs exist that fail it

kindstring
Allowed:legal_personsole_traderpublic_bodyother
legalFormstring
legalFormCodestring
namestring
registrationsRegistration[] | null
Show properties
Array of Registration
activebooleanrequired
namestring

The subject's name in this record

numberstring

Registration number (oddiel/vložka or trade licence number)

officestring

Registration court or office

registerstring

Source register, e.g. Obchodný register

registerCodestring
terminatedOnstring
validFromstring
sourceSourceRefrequired
statestringrequired
Allowed:presentabsentunknown
terminatedOnstring
riskRiskrequired
Show properties
entriesListEntry[] | null

ds_dphz (grounds to cancel VAT registration), ds_dphv (removed from that list), ds_dpho (special scheme)

Show properties
Array of ListEntry
attrsobject
datasetstringrequired
reliabilityIndexstring

ds_iz_ran: vysoko spoľahlivý, spoľahlivý, menej spoľahlivý

sourceSourceRefrequired
statestringrequired
Allowed:presentabsentunknown
taxTaxrequired
Show properties
dicstring
sourceSourceRefrequired
statestringrequired
Allowed:presentabsentunknown
vatVATrequired
Show properties
icDphstring
namestring

Name as registered for VAT

paragraphstring

§7 and §7a are registered but are not VAT payers

Allowed:§4§4b§5§7§7a
payerboolean | nullrequired

true/false only from fresh data; null when unknown

payerFromstring

Always null for §7 and §7a

registeredOnstring
sourceSourceRefrequired
statestringrequired
Allowed:presentabsentunknown
typeChangedOnstring
taxpayerTaxpayer

A natural person without an IČO, found by DIČ (authenticated callers only)

Show properties
dicstringrequired
municipalitystring
namestring
sourceSourceRefrequired
Show properties
asOfstring

As-of date of the dataset (the agency's date)

changedAtstring<date-time>

When the register last saw this content change

datasetstringrequired
stalebooleanrequired
versionstring

Content hash of the section; compare to detect changes

typestringrequired
Allowed:icodicic_dph
statusinteger<int64>required

HTTP status this id would get from /v1/lookup/{id}

versionsobject[] | null

Per subject: section → state and version

400

Bad Request

codestringrequired

Stable error code: invalid_request, invalid_identifier, unauthorized, forbidden, not_found, rate_limited, fuzzy_disabled, unavailable, internal

detailstring

Explanation specific to this occurrence

errorsErrorDetail[] | null

Validation details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

reasonstring

For unavailable: bootstrapping, setup, source_stale, timeout, database, overloaded

statusinteger<int64>required

HTTP status code

titlestringrequired

Short summary of the problem type

typestring

A URI reference for the problem type

401

Unauthorized

codestringrequired

Stable error code: invalid_request, invalid_identifier, unauthorized, forbidden, not_found, rate_limited, fuzzy_disabled, unavailable, internal

detailstring

Explanation specific to this occurrence

errorsErrorDetail[] | null

Validation details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

reasonstring

For unavailable: bootstrapping, setup, source_stale, timeout, database, overloaded

statusinteger<int64>required

HTTP status code

titlestringrequired

Short summary of the problem type

typestring

A URI reference for the problem type

422

Unprocessable Entity

codestringrequired

Stable error code: invalid_request, invalid_identifier, unauthorized, forbidden, not_found, rate_limited, fuzzy_disabled, unavailable, internal

detailstring

Explanation specific to this occurrence

errorsErrorDetail[] | null

Validation details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

reasonstring

For unavailable: bootstrapping, setup, source_stale, timeout, database, overloaded

statusinteger<int64>required

HTTP status code

titlestringrequired

Short summary of the problem type

typestring

A URI reference for the problem type

429

Too Many Requests

codestringrequired

Stable error code: invalid_request, invalid_identifier, unauthorized, forbidden, not_found, rate_limited, fuzzy_disabled, unavailable, internal

detailstring

Explanation specific to this occurrence

errorsErrorDetail[] | null

Validation details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

reasonstring

For unavailable: bootstrapping, setup, source_stale, timeout, database, overloaded

statusinteger<int64>required

HTTP status code

titlestringrequired

Short summary of the problem type

typestring

A URI reference for the problem type

500

Internal Server Error

codestringrequired

Stable error code: invalid_request, invalid_identifier, unauthorized, forbidden, not_found, rate_limited, fuzzy_disabled, unavailable, internal

detailstring

Explanation specific to this occurrence

errorsErrorDetail[] | null

Validation details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

reasonstring

For unavailable: bootstrapping, setup, source_stale, timeout, database, overloaded

statusinteger<int64>required

HTTP status code

titlestringrequired

Short summary of the problem type

typestring

A URI reference for the problem type

503

Service Unavailable

codestringrequired

Stable error code: invalid_request, invalid_identifier, unauthorized, forbidden, not_found, rate_limited, fuzzy_disabled, unavailable, internal

detailstring

Explanation specific to this occurrence

errorsErrorDetail[] | null

Validation details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

reasonstring

For unavailable: bootstrapping, setup, source_stale, timeout, database, overloaded

statusinteger<int64>required

HTTP status code

titlestringrequired

Short summary of the problem type

typestring

A URI reference for the problem type

Request
curl -X POST 'http://localhost:8080/v1/lookup:batch' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "fields": "all",
  "ids": [
    "string"
  ]
}'
Response
{
  "attribution": [
    "string"
  ],
  "items": [
    {
      "code": "string",
      "id": "string",
      "result": {
        "attribution": [
          "string"
        ],
        "subjects": [
          {
            "ico": "string",
            "identity": {
              "active": true,
              "address": {
                "buildingNumber": "string",
                "country": "string",
                "municipality": "string",
                "postalCode": "string",
                "street": "string"
              },
              "establishedOn": "string",
              "icoChecksumValid": true,
              "kind": "legal_person",
              "legalForm": "string",
              "legalFormCode": "string",
              "name": "string",
              "registrations": [
                {
                  "active": true,
                  "name": "string",
                  "number": "string",
                  "office": "string",
                  "register": "string",
                  "registerCode": "string",
                  "terminatedOn": "string",
                  "validFrom": "string"
                }
              ],
              "source": {
                "asOf": "string",
                "changedAt": "2019-08-24T14:15:22Z",
                "dataset": "string",
                "stale": true,
                "version": "string"
              },
              "state": "present",
              "terminatedOn": "string"
            },
            "risk": {
              "entries": [
                {
                  "attrs": {
                    "property1": "string",
                    "property2": "string"
                  },
                  "dataset": "string"
                }
              ],
              "reliabilityIndex": "string",
              "source": {
                "asOf": "string",
                "changedAt": "2019-08-24T14:15:22Z",
                "dataset": "string",
                "stale": true,
                "version": "string"
              },
              "state": "present"
            },
            "tax": {
              "dic": "string",
              "source": {
                "asOf": "string",
                "changedAt": "2019-08-24T14:15:22Z",
                "dataset": "string",
                "stale": true,
                "version": "string"
              },
              "state": "present"
            },
            "vat": {
              "icDph": "string",
              "name": "string",
              "paragraph": "§4",
              "payer": true,
              "payerFrom": "string",
              "registeredOn": "string",
              "source": {
                "asOf": "string",
                "changedAt": "2019-08-24T14:15:22Z",
                "dataset": "string",
                "stale": true,
                "version": "string"
              },
              "state": "present",
              "typeChangedOn": "string"
            }
          }
        ],
        "taxpayer": {
          "dic": "string",
          "municipality": "string",
          "name": "string",
          "source": {
            "asOf": "string",
            "changedAt": "2019-08-24T14:15:22Z",
            "dataset": "string",
            "stale": true,
            "version": "string"
          }
        },
        "type": "ico"
      },
      "status": 0,
      "versions": [
        {
          "property1": {
            "state": "string",
            "version": "string"
          },
          "property2": {
            "state": "string",
            "version": "string"
          }
        }
      ]
    }
  ]
}