Skip to main content
POST
Submit Batch

Authorizations

Authorization
string
header
required

Customer API key (dm_live_…)

Body

application/json
companies
MatchInput · object[]
required
Required array length: 1 - 1000 elements
callback_url
string<uri> | null

URL to POST once when the job completes or fails. Must be https except in local development.

Minimum string length: 1
webhook_secret
string | null

Optional HMAC-SHA256 secret. When set, the webhook includes X-DataMatcher-Signature: sha256= over the raw JSON body.

Required string length: 16 - 128

Response

Successful Response

job_id
string<uuid>
required
status
enum<string>
required
Available options:
queued,
running,
completed,
failed
total
integer
required
Last modified on August 20, 2026