Create business lookup
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
Create business lookup
Authorizations
API key for authentication. Access https://console.beltic.com/ to obtain your API key.
Body
application/json