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>"
}
]
}
}
}Business API
Create Business Lookup
Create a new business registry lookup request. This will queue a task to fetch business information from country-specific vendor APIs.
Processing Modes:
- Async Mode (
async: true): Returns immediately with201 Createdand processing status. Client should poll the GET endpoint for completion. - Sync Mode (
async: false): Waits up to 45 seconds for completion.- If processing completes within 45 seconds: Returns
200 OKwith full business data. - If timeout occurs: Returns
201 Createdwith processing status (client should poll for completion).
- If processing completes within 45 seconds: Returns
Country Requirements:
- US: Requires
country,official_name, andaddress - BR: Requires
countryandregistration_number - GB: Requires
countryandregistration_number - ZZ: Test country, requires
countryand at least one input field (official_name,registration_number, oraddress)
Workflow:
- Call this endpoint to create a business lookup task
- The task is queued and processed by a country-specific service
- Poll the GET endpoint (or wait in sync mode) to retrieve results
Note: The business record is created immediately with async_status: processing. The record will be updated with results when processing completes.
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
API key for authentication. Access https://console.beltic.com/ to obtain your API key.
Body
application/json
Show child attributes
Show child attributes
Was this page helpful?
⌘I