Match Companies and Contacts in Bulk

post

https://uapi.demandbase.com/data/b2b/v1/match/job

Use this endpoint to enrich company and contact records in bulk using a CSV file upload. Each row in the file represents one enrichment request and must match the supported field structure. This endpoint supports up to 10,000 records per job.

CSV Results Format:
The completed job will return a CSV file with the following structure:

Input columns from your uploaded CSV are preserved
Additional columns are added for matched company data (companyId, name, city, state, country, matchScore, etc.)
Additional columns are added for matched contact data (contactId, firstName, lastName, title, email, matchScore, etc.)
Multiple matches are returned as separate rows with the same input ID
If no matches are found, the row will contain only the input data with empty match columns

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

CSV Upload Requirements

Accepted Headers

Header	Description
id	Unique identifier for the row
city	City
companyName	Company name
country	Country
email	Email address
firstName	First name
lastName	Last name
state	State or province
street	Street address
ticker	Company ticker symbol
title	Job title
url	Company website URL
zip	Postal code
isContactRequired	Require contact-level matching
isPhoneRequired	Require phone number match
isEmailRequired	Require email match
fullName	Full name
contactMatching	Contact matching mode
executiveLinkedInHandle	Executive LinkedIn handle
phone	Phone number

Constraints

The id header is mandatory.
At least one of the following headers must exist in the CSV file:
- email
- companyName
- url
- executiveLinkedInHandle
Each row must contain a non-empty value in at least one of these columns:
- email
- companyName
- url
- executiveLinkedInHandle
Every row must contain the same number of columns as the header row.
The id value cannot be empty in any row.

Allowed Values

Header	Allowed Values
isContactRequired	`True`, `False`, or empty
isPhoneRequired	`True`, `False`, or empty
isEmailRequired	`True`, `False`, or empty
contactMatching	`active`, `all`, or empty

Responses

Field Name	Description
`ID`	Row-level identifier submitted in the request CSV
`City`	Matched company's city
`Company ID`	Unique identifier of the matched company
`Country`	Matched company's country
`Company Name`	Name of the matched company
`State`	Matched company's state or region
`Employment ID`	Matched employment/contact ID
`First Name`	Matched contact's first name
`Last Name`	Matched contact's last name
`Job Titles`	List of job titles associated with the contact
`Match Score`	Confidence score for the matched record
`DB Person ID`	Unique Demandbase person identifier
`Employment Status`	Indicates if the contact is currently employed (`current` or `past`)
`Job Levels`	Job level(s) associated with the contact (e.g., `C Level`, `Manager`)
`Job Functions`	Job function(s) associated with the contact (e.g., `Marketing`, `IT`)
`Contact Quality Score`	Contact quality rating (e.g., `A+`, `B`)
`DB Person Country`	Contact's country based on person-level data
`DB Person State`	Contact's state based on person-level data
`DB Person City`	Contact's city based on person-level data
`Street`	Street address for the company

CSV Upload Requirements

Accepted Headers

Constraints

Allowed Values

400Bad Request

401Unauthorized because the user is not authenticated.