---
title: "Hard delete rates by IDs"
method: POST
path: "/api/fee-schedules/v3/hard-delete-by-ids"
tags: ["v3"]
---

# Hard delete rates by IDs

`POST /api/fee-schedules/v3/hard-delete-by-ids`

Hard deletes specific rates from the system by their IDs. This is a destructive operation and cannot be undone. Limited to 100 rate IDs maximum per request. For bulk deletion of more than 100 rates, use the hard_delete_rates endpoint with dimension filters. Returns the number of rates deleted.

## Request body

- object
  - `rate_ids` CommonsRateId[], required

## Response `200`

Response with status 200

- integer

## Changes

- **2026-09-17** `24b2d80d577a` — 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `OAuthScheme` was added to the API
- **2026-09-12** `3a81ee81d4ed` — 1 info
  - api operation id `hard_delete_rates_by_ids` removed and replaced with `v3_hard_delete_rates_by_ids`

[Change history](https://skmtc.dev/joincandidhealth/apis/api-reference/changes/api/fee-schedules/v3/hard-delete-by-ids/post.md)

---

[API](https://skmtc.dev/joincandidhealth/apis/api-reference.md) · [All operations](https://skmtc.dev/joincandidhealth/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/joincandidhealth/apis/api-reference/revisions/4074901c170f?raw)