/bff/branch/resolve-operating-company-by-ico

Returns an existing contact with this IČO in the org, or creates a new contact and runs the ARES sync to fill in name / DIČ / VAT status. The returned contactId (CuRefNo) is the value to pass as operatingCompanyContactRef in /update.

BranchpostBffBranchResolve-operating-company-by-ico

Parameters

JSON body

Request body

application/json

companyRegistrationNumberstringRequired

IČO of the legal entity. Will be parsed/normalized server-side.

Length: 1–∞

Example27082440

countryCodestringOptional

ISO 3166-1 alpha-2 country code. Defaults to CZ.

ExampleCZ

Response schema

1 status code documented

200Success

successbooleanRequired

contactIdstringRequired

namestringRequired

companyRegistrationNumberstringOptional

taxIdentificationNumberstringOptional

createdbooleanRequired

True if a fresh contact was created in this call.

Response example

application/json

{
  "success": false,
  "contactId": "example_contactId",
  "name": "example_name",
  "companyRegistrationNumber": "example_companyRegistrationNumber",
  "taxIdentificationNumber": "example_taxIdentificationNumber",
  "created": false
}

Request example

POST /bff/branch/resolve-operating-company-by-ico

post

curl -X POST "https://api.bizkithub.com/bff/branch/resolve-operating-company-by-ico" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "companyRegistrationNumber": "27082440",
  "countryCode": "CZ"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key