---
title: "/candidates/:id"
method: DELETE
path: "/c/{company_id}/candidates/{id}"
---

# /candidates/:id

`DELETE /c/{company_id}/candidates/{id}`

## Request

- Base URL: `https://api.recruitee.com`
- URL: `https://api.recruitee.com/c/{company_id}/candidates/{id}`
- Auth: OAuth 2

Delete candidate with provided ID.

Watch out when testing the endpoint here! It will delete any found resources permanently!

## Path parameters

- `company_id` integer, required
- `id` integer, required

## Response `200`

200

- object
  - `candidate` object
    - `admin_id` integer
    - `adminapp_url` string
    - `created_at` string
    - `deleted_at` string
    - `emails` string[]
    - `example` boolean
    - `id` integer
    - `last_message_at` unknown
    - `name` string
    - `notes_count` integer
    - `phones` string[]
    - `photo_thumb_url` string
    - `placements` unknown[]
      - unknown
    - `positive_ratings` unknown
    - `rating` integer
    - `ratings` object
    - `ratings_count` integer
    - `referrer` unknown
    - `source` string
    - `tasks_count` integer
    - `updated_at` string
    - `viewed` boolean
  - `references` unknown[]
    - unknown

## Other responses

- `404`: 404

---

[API](https://skmtc.dev/recruitee/apis/ats-api.md) - [All operations](https://skmtc.dev/recruitee/apis/ats-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recruitee/apis/ats-api/revisions/92a80d21a7e0?raw)