Skip to main content

Map properties to companies

POST 
/api/v1/bulk/company-mappings
Asynchronous

This request is queued, not processed while you wait. The response carries a correlation id — poll the bulk task until it reports a terminal state. See How asynchronous processing works.

Queued, not immediate. The response carries a correlation id; poll GET /api/v2/bulk/tasks/{correlationId} until the task reports a terminal state — the finished task carries the mapping result as a single unpaged file entry whose URL is the download. Send each property with your own id plus whatever public detail you hold — name, street, coordinates, country or airport code, GIATA code, Booking.com id — and BeCause searches for the company and stores your id against the one it matches, which is what lets later calls address that company by your id alone. Requires the custom identifier id your ids are stored under (a property with isIdentifier: true from GET /api/v1/custom-properties). There is no hard limit on the payload, but do not send more than 100,000 companies in one request.

Request​

Responses​

Queued. The correlation id means the mapping run has started, not that any property has been matched yet.