---
title: "Get Rate History"
method: GET
path: "/api/fee-schedules/v3/{rate_id}/history"
tags: ["v3"]
---

# Get Rate History

`GET /api/fee-schedules/v3/{rate_id}/history`

## Request

- Base URL: `https://pre-api.joincandidhealth.com`
- URL: `https://pre-api.joincandidhealth.com/api/fee-schedules/v3/{rate_id}/history`
- Auth: HTTP bearer

Gets every version of a rate.

## Path parameters

- `rate_id` string, uuid, required

## Response `200`

Response with status 200

- FeeSchedulesV3Rate[]
  - `rate_id` string, uuid, required
  - `dimensions` FeeSchedulesV3Dimensions, required: Dimension values that qualify a rate. For the optional dimensions, a null value signifies "all apply". For set-type dimensions, an empty set signifies "all apply". Only one of, but not both, of `network_types` and `payer_plan_group_id` may be populated.
    - `payer_uuid` string, uuid, required
    - `organization_billing_provider_id` string, uuid, required
    - `states` CommonsState[], required
    - `zip_codes` string[], required
    - `license_types` OrganizationProvidersV2LicenseType[], required
    - `facility_type_codes` CommonsFacilityTypeCode[], required
    - `network_types` CommonsNetworkType[], required
    - `payer_plan_group_ids` CommonsPayerPlanGroupId[], required
    - `cpt_code` string, required
    - `modifiers` CommonsProcedureModifier[], required
  - `version` integer, required: The version of this rate in the system.
  - `updated_at` string, date, required
  - `updated_by` string, uuid, required
  - `entries` FeeSchedulesV3RateEntry[], required
    - `start_date` string, date, required
    - `end_date` string, date
    - `rate_cents` integer, required
    - `is_deactivated` boolean, required

## Other responses

- `404`: Error response with status 404

## Changes

- **2026-10-15** `97de8fddb088`: 1 warning
  - added the new `RT` enum value to the `items/dimensions/license_types/items/` response property for the response status `200`
- **2026-10-02** `7fd881bab7b6`: 2 warning
  - added the new `WC` enum value to the `items/dimensions/modifiers/items/` response property for the response status `200`
  - added the new `WH` enum value to the `items/dimensions/modifiers/items/` response property for the response status `200`
- **2026-09-17** `24b2d80d577a`: 1 breaking, 1 warning, 7 info
  - the `items/` response's property type changed from no type to `object` for status `200`
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `OAuthScheme` was added to the API
  - added the required property `items/dimensions` to the response with the `200` status
  - …5 more
- **2026-09-12** `3a81ee81d4ed`: 1 info
  - api operation id `get_rate_history` removed and replaced with `v3_get_rate_history`

[Operation history](https://skmtc.dev/joincandidhealth/apis/api-reference/changes/api/fee-schedules/v3/:rate_id/history/get.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/d8b0a61873e2?raw)