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>'import requests
url = "https://api.usecobalt.com/v1/fee-schedules"
headers = {
"client_id": "<api-key>",
"client_secret": "<api-key>",
"access_token": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {client_id: '<api-key>', client_secret: '<api-key>', access_token: '<api-key>'}
};
fetch('https://api.usecobalt.com/v1/fee-schedules', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.usecobalt.com/v1/fee-schedules",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"access_token: <api-key>",
"client_id: <api-key>",
"client_secret: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.usecobalt.com/v1/fee-schedules"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("client_id", "<api-key>")
req.Header.Add("client_secret", "<api-key>")
req.Header.Add("access_token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.usecobalt.com/v1/fee-schedules")
.header("client_id", "<api-key>")
.header("client_secret", "<api-key>")
.header("access_token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.usecobalt.com/v1/fee-schedules")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["client_id"] = '<api-key>'
request["client_secret"] = '<api-key>'
request["access_token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"fee_schedules": [
{
"id": "f47ac10b58cc4372a5670e02b2c3d479",
"emr_id": "fee-schedule-123",
"name": "Standard office fees",
"description": "Office visit fee schedule",
"sub_name": "2026",
"is_master": true,
"taxable": false,
"effective_from": "2026-01-01",
"effective_to": "2026-12-31",
"item_count": 1
}
]
}{
"success": false,
"message": "Bad request — missing or invalid parameters"
}{
"success": false,
"message": "Unauthorized — missing or invalid credentials"
}{
"success": false,
"message": "Internal server error"
}Fee Schedules
Get Fee Schedules
Returns the fee schedules configured for a clinic.
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>'import requests
url = "https://api.usecobalt.com/v1/fee-schedules"
headers = {
"client_id": "<api-key>",
"client_secret": "<api-key>",
"access_token": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {client_id: '<api-key>', client_secret: '<api-key>', access_token: '<api-key>'}
};
fetch('https://api.usecobalt.com/v1/fee-schedules', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.usecobalt.com/v1/fee-schedules",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"access_token: <api-key>",
"client_id: <api-key>",
"client_secret: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.usecobalt.com/v1/fee-schedules"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("client_id", "<api-key>")
req.Header.Add("client_secret", "<api-key>")
req.Header.Add("access_token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.usecobalt.com/v1/fee-schedules")
.header("client_id", "<api-key>")
.header("client_secret", "<api-key>")
.header("access_token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.usecobalt.com/v1/fee-schedules")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["client_id"] = '<api-key>'
request["client_secret"] = '<api-key>'
request["access_token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"fee_schedules": [
{
"id": "f47ac10b58cc4372a5670e02b2c3d479",
"emr_id": "fee-schedule-123",
"name": "Standard office fees",
"description": "Office visit fee schedule",
"sub_name": "2026",
"is_master": true,
"taxable": false,
"effective_from": "2026-01-01",
"effective_to": "2026-12-31",
"item_count": 1
}
]
}{
"success": false,
"message": "Bad request — missing or invalid parameters"
}{
"success": false,
"message": "Unauthorized — missing or invalid credentials"
}{
"success": false,
"message": "Internal server error"
}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
Query Parameters
Page number. Every fee schedule is returned on one page. Accepted, but no EMR uses it, so it has no effect.
Required range:
x >= 1Example:
1
Results per page. Every fee schedule is returned on one page. Accepted, but no EMR uses it, so it has no effect.
Required range:
x >= 1Example:
100
Response
Fee-schedule headers for the account
Example:
true
Show child attributes
Show child attributes
Example:
[
{
"id": "f47ac10b58cc4372a5670e02b2c3d479",
"emr_id": "fee-schedule-123",
"name": "Standard office fees",
"description": "Office visit fee schedule",
"sub_name": "2026",
"is_master": true,
"taxable": false,
"effective_from": "2026-01-01",
"effective_to": "2026-12-31",
"item_count": 1
}
]