Skip to main content
GET
List fee-schedule items
A fee schedule contains the full CPT/HCPCS catalog (thousands of codes), so its items are paginated. Get the feeScheduleId from Get Fee Schedules, then page through the codes here. You can narrow results with search (code or description) and validity.

Example Request

Example Response

Query Parameters

  • page: Page number (default 1).
  • page_size: Items per page (default 100, max 500).
  • search: Filter by code or description (case-insensitive).
  • validity: Filter to valid or invalid codes.

Response Parameters

  • item_id: EMR item identifier, stable per code within the schedule.
  • code: CPT/HCPCS code.
  • name: Code description.
  • fee: Billed/charge amount. allowed_fee: Contracted allowed amount. These differ per schedule for the same code.
  • cost / patient_portion: Cost and patient-portion amounts.
  • bill_to_patient / exclude_cpt: Billing flags.
  • modifiers: Procedure modifiers (only non-empty slots are returned).
  • pos / tos: Place of service / type of service.
  • ndc: National Drug Code details (code, units, uom, unit_price).
  • validity: valid or invalid. Invalid codes are retained so historical claims can still be cross-referenced.
  • pagination: page, page_size, total_records, total_pages.

Authorizations

client_id
string
header
required
client_secret
string
header
required
access_token
string
header
required

Path Parameters

feeScheduleId
string
required

Cobalt fee-schedule ID.

Example:

"fee-schedule-123"

Query Parameters

Filter by CPT/HCPCS code or description.

Example:

"99213"

validity
string

Filter by validity. One of: "valid", "invalid".

Example:

"valid"

page
integer
default:1

Page number.

Required range: x >= 1
page_size
integer
default:100

Items per page (max 500).

Required range: 1 <= x <= 500

Response

A page of fee-schedule items

success
boolean
required
items
object[]
required
pagination
object
required