Add random jitter (0–500 ms) so concurrent clients do not synchronise retries.
Do not auto-retry 401, 404, 409, or 422 with the same payload. Fix the key, id, timing, or body first.
Common scenarios
401 on every call
Almost always a missing Authorization header, a JWT instead of a dm_live_… key, or a revoked key.
422 on batch submit
Either a company object failed validation (for example empty input_name), the list exceeds 1,000 companies, or callback_url / webhook_secret failed validation.
409 on results
You called GET /match/batch/{job_id}/results while the job was still queued. Poll GET /match/batch/{job_id} until status is running, completed, or failed, then fetch results.
Client timeout on POST /match
Matching can take tens of seconds on a cold path. Set the client timeout to at least 60–120 seconds before treating the call as failed.
Last modified on October 7, 2026
Was this page helpful?
Assistant
Responses are generated using AI and may contain mistakes.