Skip to main content
GET
/
v1
/
businesses
List business records
curl --request GET \
  --url https://api.beltic.com/v1/businesses \
  --header 'X-Api-Key: <api-key>'
{
  "data": [
    {
      "id": "<string>",
      "type": "business",
      "attributes": {
        "is_registered": true,
        "official_name": "<string>",
        "status": "<string>",
        "legal_form": "<string>",
        "registration_date": "<string>",
        "dissolution_date": "<string>",
        "translation": {
          "official_name": "<string>",
          "status": "<string>",
          "legal_form": "<string>"
        },
        "registered_address": {
          "formatted_address": "<string>",
          "street": "<string>",
          "city": "<string>",
          "state_or_province": "<string>",
          "postal_code": "<string>",
          "country": "<string>",
          "street2": "<string>",
          "po_box": "<string>",
          "latitude": 123,
          "longitude": 123,
          "start_date": "<string>",
          "end_date": "<string>",
          "translation": {
            "official_name": "<string>",
            "status": "<string>",
            "legal_form": "<string>"
          }
        },
        "physical_address": {
          "formatted_address": "<string>",
          "street": "<string>",
          "city": "<string>",
          "state_or_province": "<string>",
          "postal_code": "<string>",
          "country": "<string>",
          "street2": "<string>",
          "po_box": "<string>",
          "latitude": 123,
          "longitude": 123,
          "start_date": "<string>",
          "end_date": "<string>",
          "translation": {
            "official_name": "<string>",
            "status": "<string>",
            "legal_form": "<string>"
          }
        },
        "identifiers": [
          {
            "type": "<string>",
            "value": "<string>"
          }
        ],
        "industry": [
          {
            "code": "<string>",
            "description": "<string>",
            "system": "<string>",
            "is_primary": true,
            "translation": {
              "official_name": "<string>",
              "status": "<string>",
              "legal_form": "<string>"
            }
          }
        ],
        "capital": {
          "registered": {
            "amount": 123,
            "currency": "<string>"
          },
          "paid_up": {
            "amount": 123,
            "currency": "<string>"
          }
        },
        "officers": [
          {
            "name": "<string>",
            "type": "<string>",
            "date_of_birth": "<string>",
            "id_type": "<string>",
            "id_number": "<string>",
            "start_date": "<string>",
            "end_date": "<string>",
            "address_detail": {
              "formatted_address": "<string>",
              "street": "<string>",
              "city": "<string>",
              "state_or_province": "<string>",
              "postal_code": "<string>",
              "country": "<string>",
              "street2": "<string>",
              "po_box": "<string>",
              "latitude": 123,
              "longitude": 123,
              "start_date": "<string>",
              "end_date": "<string>",
              "translation": {
                "official_name": "<string>",
                "status": "<string>",
                "legal_form": "<string>"
              }
            },
            "translation": {
              "official_name": "<string>",
              "status": "<string>",
              "legal_form": "<string>"
            },
            "states": [
              "<string>"
            ],
            "sources": [
              "<string>"
            ]
          }
        ],
        "shareholders": [
          {
            "name": "<string>",
            "shareholder_type": "<string>",
            "date_of_birth": "<string>",
            "id_type": "<string>",
            "id_number": "<string>",
            "number_of_share": "<string>",
            "percentage_of_share": 123,
            "effective_date": "<string>",
            "end_date": "<string>",
            "translation": {
              "official_name": "<string>",
              "status": "<string>",
              "legal_form": "<string>"
            }
          }
        ],
        "contacts": [
          {
            "type": "<string>",
            "value": "<string>",
            "description": "<string>",
            "start_date": "<string>",
            "end_date": "<string>"
          }
        ],
        "name_history": [
          {
            "name": "<string>",
            "effective_date": "<string>",
            "end_date": "<string>",
            "translation": {
              "official_name": "<string>",
              "status": "<string>",
              "legal_form": "<string>"
            }
          }
        ],
        "activity_history": [
          {
            "activity": "<string>",
            "date": "<string>"
          }
        ],
        "latest_annual_return": {
          "year_of_filing": "<string>",
          "annual_meeting_date": "<string>"
        }
      },
      "relationships": {
        "sessions": {
          "data": [
            {
              "type": "<string>",
              "id": "<string>"
            }
          ]
        }
      }
    }
  ],
  "meta": {
    "page": {
      "size": 123,
      "has_next": true,
      "has_previous": true,
      "start_cursor": "<string>",
      "end_cursor": "<string>",
      "total": 1
    }
  },
  "links": {
    "first": "<string>",
    "prev": "<string>",
    "next": "<string>",
    "last": "<string>"
  }
}

Authorizations

​
X-Api-Key
string
header
required

API key for authentication. Access https://console.beltic.com/ to obtain your API key.

Query Parameters

​
filter[async_status]
enum<string>

Filter by async status

Available options:
processing,
succeeded,
not_found,
canceled
Example:

"succeeded"

​
filter[country]
string

Filter by country code

Example:

"US"

​
page[size]
integer

Number of records per page

Required range: x <= 100
Example:

15

​
page[after]
string

Cursor for next page

​
page[before]
string

Cursor for previous page

​
page[total]
boolean | null

Include total count in response

Example:

false

Response

Business records retrieved successfully

​
data
object[]
required
​
meta
object
required
​
links
object
required