Skip to Content
CallMitraDocs
Errors

number_on_dnc

This number is on the DNC list and will not be dialed.

HTTP statusTypeCode
409conflict_errornumber_on_dnc

What it means

The lead opted out or its number is on your do-not-call list. Remove it with DELETE /leads/dnc/{leadId} only if the person agreed to be called again.

How to handle it

Fetch the resource again to see its current state, then decide whether to retry.

Example response

{
  "detail": "This number is on the DNC list and will not be dialed.",
  "error": {
    "type": "conflict_error",
    "code": "number_on_dnc",
    "message": "This number is on the DNC list and will not be dialed.",
    "param": null,
    "docUrl": "https://docs.callmitra.ai/errors/number_on_dnc",
    "requestId": "req_3f9c2a7d1b8e4c6a9f0e2d4b6a8c0e1f"
  }
}

Branch on error.code; it never changes once published. The message text can change. See Errors for the envelope.

Returned by

  • POST /api/v1/leads/{lead_id}/call-now — Call a lead now
  • POST /api/v1/instant/call-now — Call a lead in a campaign now
  • POST /api/v1/calls/ — Place a call

On this page