Skip to main content
POST
/
v1
/
businesses
Create business lookup
curl --request POST \
  --url https://api.beltic.com/v1/businesses \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "data": {
    "type": "business",
    "meta": {
      "search_parameters": {
        "country": "US",
        "input": {
          "official_name": "<string>",
          "registration_number": "<string>",
          "address": "<string>"
        },
        "async": false
      }
    },
    "relationships": {
      "session": {
        "data": {
          "type": "session",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      }
    }
  }
}
'
{
  "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>"
        }
      ]
    }
  }
}

Authorizations

X-Api-Key
string
header
required

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

Body

application/json
data
object
required

Response

Business lookup completed (sync mode only). Returned when async: false and processing completes within 45 seconds.

id
string
required
type
enum<string>
required
Available options:
business
attributes
object
required
relationships
object
required