/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

2 body

2 total

Body · 2

companyRegistrationNumberstringRequired

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

Length: 1–∞

countryCodestring

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

Request

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"
}'

Response

JSON payload

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

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key