Skip to main content
POST
/
api
/
ares
/
companies
/
search
/ares/companies/search
curl --request POST \
  --url https://api.anysite.io/api/ares/companies/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "name": "Seznam",
  "ico": [
    "<string>"
  ],
  "text_address": "Brno",
  "municipality_code": 582786,
  "cz_nace": [
    "62"
  ],
  "legal_form": [
    "112"
  ],
  "legal_form_ros": [
    "112"
  ],
  "financial_authority": [
    "004"
  ]
}
'
[
  {
    "ico": "<string>",
    "name": "<string>",
    "@type": "@ares_company",
    "dic": "<string>",
    "legal_form": "<string>",
    "legal_form_ros": "<string>",
    "financial_authority": "<string>",
    "created_at": "<string>",
    "dissolved_at": "<string>",
    "updated_at": "<string>",
    "primary_source": "<string>",
    "cz_nace": [
      "<string>"
    ],
    "address": {
      "@type": "@ares_address",
      "text": "<string>",
      "street": "<string>",
      "house_number": 123,
      "orientation_number": 123,
      "orientation_number_letter": "<string>",
      "city": "<string>",
      "city_part": "<string>",
      "district": "<string>",
      "region": "<string>",
      "postal_code": 123,
      "country": "<string>",
      "country_code": "<string>"
    },
    "mailing_address": {
      "@type": "@ares_mailing_address",
      "line1": "<string>",
      "line2": "<string>",
      "line3": "<string>"
    },
    "registrations": {
      "@type": "@ares_registrations",
      "public_register": "<string>",
      "trade_register": "<string>",
      "statistical_register": "<string>",
      "register_of_persons": "<string>",
      "vat": "<string>"
    }
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required

Max number of results

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
name
string | null

Company name to search for

Example:

"Seznam"

ico
string[] | null

One or more identification numbers (ICO)

text_address
string | null

Registered-office address text to match

Example:

"Brno"

municipality_code
integer | null

Registered-office municipality code (RUIAN kodObce)

Example:

582786

cz_nace
string[] | null

CZ-NACE economic activity codes

Example:
["62"]

Legal form codes

Example:
["112"]

Legal form codes in the register of persons

Example:
["112"]
financial_authority
string[] | null

Financial authority codes

Example:
["004"]

Response

Successful Response

ico
string
required
name
string
required
@type
string
default:@ares_company
dic
string | null
financial_authority
string | null
created_at
string | null
dissolved_at
string | null
updated_at
string | null
primary_source
string | null
cz_nace
string[]
address
AresAddress · object
mailing_address
AresMailingAddress · object
registrations
AresRegistrations · object