Company mapping result

Produced by POST /api/v1/bulk/company-mappings; the task reports "requestType": "BulkMapCompanies". A single-file result: the task's result reports pageSize: -1 and holds a single page entry with companyCount: -1, and the file behind its url is a CSV — one row per company you sent, in the order you sent them, with the BeCause company it was matched to and that company's certifications.

The file is UTF-8 with a byte-order mark, comma-separated, with a header row — Excel opens it directly. Text values containing commas or quotes are quoted the standard way.

Columns

In order. A cell is empty when there is nothing to say — a company that matched nothing has its input columns filled and every BeCause … and Certification … column empty.

Outcome

Column	Values
Confidence	How sure the match is: ExistingMatch (the company was already mapped to this BeCause company), Exceptional, VeryHigh, High, Medium, Low, VeryLow, or ManualMatch (mapped by hand on the BeCause side). Empty when the row matched nothing or could not be parsed.
ParsingError	Why the row could not be processed at all — a missing required field, coordinates that do not parse. Empty for rows that were processed.

Low-confidence matches are included only when the request set "includeLowConfidenceMatches": true; by default a row whose best candidate is below the threshold reports no match.

Your input, echoed

These columns repeat what you sent, so the file joins back to your own records without a lookup.

Column	Notes
Id	Your identifier for the company, as sent.
Name
Street
City
ThreeLetterCountryCode
Region
ZipCode
Latitude
Longitude
AdditionalProperty1Id … AdditionalProperty4Id	The custom-property ids of up to four additional properties you sent with the company.
AdditionalProperty1Value … AdditionalProperty4Value	Their values.

The matched BeCause company

Column	Notes
BeCause Id	The company id the rest of the API uses — what you store, and what the other exports and the imports' identifiedBy.companyId join on.
BeCause Name
BeCause City
BeCause ThreeLetterCountryCode
BeCause ZipCode
BeCause Region
BeCause Street
BeCause Latitude
BeCause Longitude

Certifications, up to five

Four columns per certification slot, Certification 1 … through Certification 5 …. Slots beyond the company's certification count are empty.

Column	Notes
Certification n Name
Certification n Level (if any)	The level name, when the certification has levels.
Certification n Valid Until	yyyy-MM-dd.
Certification n Issuer	The name of the company that issued it.

Which certifications appear follows the request: certificationIds or certificationTags narrow them, includeExpiredCertificationHolders admits lapsed ones.

Delta columns

When the request set deltaSinceUtc, the file gains Mapping changes since <date> and one Certification n changes since <date> per slot, describing what changed for that row since the given date.

Example

Confidence,ParsingError,Id,Name,Street,City,ThreeLetterCountryCode,Region,ZipCode,Latitude,Longitude,AdditionalProperty1Id,AdditionalProperty1Value,AdditionalProperty2Id,AdditionalProperty2Value,AdditionalProperty3Id,AdditionalProperty3Value,AdditionalProperty4Id,AdditionalProperty4Value,BeCause Id,BeCause Name,BeCause City,BeCause ThreeLetterCountryCode,BeCause ZipCode,BeCause Region,BeCause Street,BeCause Latitude,BeCause Longitude,Certification 1 Name,Certification 1 Level (if any),Certification 1 Valid Until,Certification 1 Issuer,Certification 2 Name,…
VeryHigh,,HTL-12345,Hotel Aurora,Harbour Street 1,Copenhagen,DNK,,1000,55.67,12.56,,,,,,,,,9c56d3a1-8b0f-4c7a-9e2d-5b1a7f3e0c11,Hotel Aurora,Copenhagen,DNK,1000,Capital Region,Harbour Street 1,55.67,12.56,Green Stay Certification,Gold,2027-01-01,Green Stay Foundation,,…
,,HTL-12346,Seaside Inn,Beach Road 9,Aarhus,DNK,,8000,56.15,10.21,,,,,,,,,,,,,,,,,,,,,,…