---
title: "Get Match"
method: GET
path: "/api/fee-schedules/v3/service-line/{service_line_id}/match"
tags: ["v3"]
---

# Get Match

`GET /api/fee-schedules/v3/service-line/{service_line_id}/match`

## Request

- Base URL: `https://pre-api.joincandidhealth.com`
- URL: `https://pre-api.joincandidhealth.com/api/fee-schedules/v3/service-line/{service_line_id}/match`
- Auth: HTTP bearer

Gets the rate that matches a service line.  No result means no rate exists matching the service line's dimensions.

## Path parameters

- `service_line_id` string, uuid, required

## Response `200`

Response with status 200

- FeeSchedulesV3MatchResult
  - `threshold` FeeSchedulesV3ThresholdMatch, required: Threshold and dollar amount matching for a service line
    - `threshold` FeeSchedulesV3PayerThreshold, required: Rate thresholds that determine fee schedule rate matching behavior. When a service line is adjudicated by a payer Candid determines if the payer's allowed amount "matches" the rate value. If the allowed amount doesn't equal the rate value, Candid moves the claim to a PAID_INCORRECTLY state. These optional thresholds allow a user to set wiggle room to avoid claims moving to PAID_INCORRECTLY and instead have them move directly to FINALIZED_PAID when the payer's allowed amount is greater than [rate_cents - lower_threshold_cents] and less than [rate_cents + upper_threshold_cents]. Additionally, a client can set disable_paid_incorrectly to avoid the PAID_INCORRECTLY claim status entirely.
      - `upper_threshold_cents` integer
      - `lower_threshold_cents` integer
      - `disable_paid_incorrectly` boolean, required
    - `rate_cents` integer, required
    - `match` boolean, required
    - `explanation` string, required
  - `rate_id` string, uuid, required

## Other responses

- `404`: Error response with status 404
- `422`: Error response with status 422

## Changes

- **2026-09-17** `24b2d80d577a`: 1 breaking, 1 warning, 3 info
  - the response's body 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 `rate_id` to the response with the `200` status
  - …1 more
- **2026-09-12** `3a81ee81d4ed`: 1 info
  - api operation id `get_match` removed and replaced with `v3_get_match`

[Operation history](https://skmtc.dev/joincandidhealth/apis/api-reference/changes/api/fee-schedules/v3/service-line/:service_line_id/match/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)