Skip to main content
GET
/
fee-schedules
List fee schedules
curl --request GET \
  --url https://api.usecobalt.com/v1/fee-schedules \
  --header 'access_token: <api-key>' \
  --header 'client_id: <api-key>' \
  --header 'client_secret: <api-key>'
{
  "success": true,
  "fee_schedules": [
    {
      "id": "<string>",
      "emr_id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "sub_name": "<string>",
      "is_master": true,
      "taxable": true,
      "effective_from": "2023-12-25",
      "effective_to": "2023-12-25",
      "item_count": 123
    }
  ]
}
A clinic can have multiple fee schedules (for example a Master schedule, a Medicare schedule, and a Self-Pay schedule). The CPT/HCPCS catalog is shared across schedules, so each code appears in every schedule with that schedule’s own charge and allowed amounts. This endpoint returns the schedule headers with an item count. To read the per-code pricing for a schedule, use its id with Get Fee Schedule Items.

​
Example Request

curl -X GET https://api.usecobalt.com/v1/fee-schedules \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-H 'access_token: 493JKLHIU98789hLKH9HHJH'

​
Example Response

{
    "success": true,
    "fee_schedules": [
        {
            "id": "abc123def4567890abcdef1234567890",
            "emr_id": "2",
            "name": "2014 Medicare Fee Schedule",
            "description": "Medicare Fee Schedule - 2014",
            "sub_name": "Medicare Fee Schedule - 2014",
            "is_master": false,
            "taxable": false,
            "effective_from": "2014-01-01",
            "effective_to": "2034-12-31",
            "item_count": 2624
        },
        {
            "id": "def456abc7890123def456abc7890123",
            "emr_id": "1",
            "name": "Master Fee Schedule",
            "description": "",
            "sub_name": "",
            "is_master": true,
            "taxable": false,
            "effective_from": null,
            "effective_to": null,
            "item_count": 2624
        }
    ]
}

​
Response Parameters

  • id: Cobalt’s fee schedule identifier. Use this in the items endpoint path.
  • emr_id: The fee schedule identifier as it appears in the EMR.
  • name / description / sub_name: Labels from the EMR.
  • is_master: Whether this is the master fee schedule.
  • taxable: Whether the schedule is marked taxable.
  • effective_from / effective_to: The schedule’s effective date range (either may be null). Useful for cross-referencing a historical claim against the schedule that was in effect at the time.
  • item_count: Number of priced codes in the schedule.

Authorizations

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

Response

Successful response

​
success
boolean
​
fee_schedules
object[]