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": "<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
}
]
}{
"success": false,
"message": "<string>"
}{
"success": false,
"message": "<string>"
}{
"success": false,
"message": "<string>"
}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": "<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
}
]
}{
"success": false,
"message": "<string>"
}{
"success": false,
"message": "<string>"
}{
"success": false,
"message": "<string>"
}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
Accepted for compatibility but ignored — every fee schedule is returned.
Required range:
x >= 1Accepted for compatibility but ignored — every fee schedule is returned.
Required range:
x >= 1