Companies

List or search companies.

Two paths:

  • Filter mode when q is absent: filter by country, company_number, company_type_code, status, superseded, incorporation_from/incorporation_to, geo (near/bbox), paginated by name.
  • Search mode when q is present: full-text on company name, optional country filter, ranked by score.
get/v3/companies

Request

  • Base URL: https://api.datocapital.com
  • URL: https://api.datocapital.com/v3/companies
  • Auth: HTTP bearer

Query parameters

qstring

Full-text query. 2-200 chars.

countrystring
company_numberstring

SQL mode only.

company_number_secondarystring

SQL mode only.

company_type_codestring

SQL mode only.

status'open' | 'closed'

SQL mode only.

supersededboolean

SQL mode only.

incorporation_fromstring date

SQL mode only.

incorporation_tostring date

SQL mode only.

nearstring

lat,lon center for radius search (SQL mode).

radiusnumber

Required with near.

radius_unit'm' | 'km' | 'mi'
bboxstring

minLon,minLat,maxLon,maxLat (GeoJSON order). Max 5° per side.

language'en' | 'es' | 'fr' | 'nl'

Localised label resolution for status.

page_sizeinteger

Items per page. A value above your plan's page size (max_page_size in /v3/whoami: free 25, starter 50, pro 100) is reduced to that size; next_cursor continues from the last item.

cursorstring

Opaque token taken from a prior response's next_cursor.

Response

ok

next_cursorstring nullable
has_moreboolean
total_estimateinteger

Search-mode only (when q is set).

Example response

{
  "data": [
    {
      "uec": "9243433317131893",
      "company_type": {
        "id": "0",
        "code": "SL",
        "name_local": "SOCIEDAD LIMITADA",
        "country": "ES"
      },
      "status": {
        "id": "1",
        "name_local": "Active"
      },
      "registered_address": {
        "country": "ES"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.