Get Fee Schedules - Documentation

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": true,
  "message": "<string>"
}

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": true,
  "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

client_id

string

header

required

client_secret

string

header

required

access_token

string

header

required

Response

Successful response

success

boolean

fee_schedules

object[]

Show child attributes

Get Eligibility Benefits Get Fee Schedule Items

​Example Request

​Example Response

​Response Parameters

Authorizations

Response

Example Request

Example Response

Response Parameters