# lead_not_found (/errors/lead_not_found)

| HTTP status | Type | Code |
| --- | --- | --- |
| 404 | `not_found_error` | `lead_not_found` |

## What it means [#what-it-means]

No lead with this id exists in your workspace, or it was deleted. Find leads with `GET /leads` and use one of the returned ids.

## How to handle it [#how-to-handle-it]

Check the ID in the path. It may be wrong, deleted, or belong to another workspace; the API answers 404 rather than revealing other workspaces’ data.

## Example response [#example-response]

```json
{
  "detail": "Lead not found.",
  "error": {
    "type": "not_found_error",
    "code": "lead_not_found",
    "message": "Lead not found.",
    "param": null,
    "docUrl": "https://docs.callmitra.ai/errors/lead_not_found",
    "requestId": "req_3f9c2a7d1b8e4c6a9f0e2d4b6a8c0e1f"
  }
}
```

Branch on `error.code`; it never changes once published. The `message` text can change. See [Errors](/errors) for the envelope.

## Returned by [#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
- `POST /api/v1/leads/{lead_id}/notes` — Add a note
- `DELETE /api/v1/leads/{lead_id}` — Delete a lead
- `DELETE /api/v1/leads/{lead_id}/notes/{note_id}` — Delete a note
- `GET /api/v1/leads/{lead_id}` — Get a lead
- `GET /api/v1/leads/{lead_id}/timeline` — Lead timeline
- `GET /api/v1/leads/{lead_id}/notes` — List a lead's notes
- `POST /api/v1/leads/{lead_id}/notes/{note_id}/pin` — Pin a note
- `DELETE /api/v1/leads/dnc/{lead_id}` — Remove a number from do-not-call
- `DELETE /api/v1/leads/{lead_id}/notes/{note_id}/pin` — Unpin a note
- `PUT /api/v1/campaigns/{campaign_id}/leads` — Add or remove leads
- `PUT /api/v1/leads/{lead_id}` — Update a lead
- `PATCH /api/v1/leads/{lead_id}/notes/{note_id}` — Edit a note