Utilization

Historical service volumes and allowed amounts.

GET/api/v1/utilization

Browse historical utilization

GET /api/v1/utilization returns historical CMS service counts, beneficiary counts, and average allowed amounts. These observations are separate from current fee-schedule prices.

Optional attributes

Name
year
Type
integer
Description
Defaults to the installed snapshot year (currently 2024). Unsupported years return data_unavailable.
Name
setting
Type
string
Description
non_facility (default) or facility.
Name
sort
Type
string
Description
services (default), beneficiaries, or average_allowed, descending.
Name
codes[]
Type
string[]
Description
1–50 distinct five-character codes.
Name
page
Type
integer
Description
Page number, starting at 1. Defaults to 1; maximum 10,000.
Name
limit
Type
integer
Description
Results per page. Defaults to 25; accepts 1–100.

Parameter usage notes

year defaults to the installed snapshot year, currently 2024. Other years return 422 data_unavailable.

setting is non_facility (default) or facility. sort is descending services (default), beneficiaries, or average_allowed, with code as the tie-breaker. codes[] optionally filters up to 50 distinct codes. page defaults to 1; limit defaults to 25, maximum 100.

Response

Name
data
Type
object[]
Description
Historical observations.
Name
data[].code
Type
string
Description
Procedure code.
Name
data[].setting
Type
string
Description
facility or non_facility.
Name
data[].year
Type
integer
Description
Snapshot year.
Name
data[].rank
Type
integer
Description
Rank before code filtering.
Name
data[].services
Type
decimal string
Description
Number of services in the dataset.
Name
data[].beneficiaries
Type
decimal string
Description
Number of beneficiaries in the dataset.
Name
data[].average_allowed
Type
integer
Description
Average allowed amount in USD cents.
Name
data[].currency
Type
string
Description
Always usd.
Name
data[].source_row
Type
integer
Description
Source data row.
Name
meta.source
Type
object
Description
Snapshot year, publication date, source URL, hash, dictionary, landing URL, and selection notes.
Name
meta.sort
Type
string
Description
Metric used to sort observations.
Name
meta.page
Type
integer
Description
Current page number.
Name
meta.limit
Type
integer
Description
Maximum results per page.
Name
meta.total
Type
integer
Description
Total matching records.
Name
meta.next_page
Type
integer | null
Description
Next page number, or null when there are no more pages.

Response behavior and edge cases

The response contains data and meta. Rows contain code, setting, year, rank, services, beneficiaries, average_allowed, currency, and source_row. Counts retain the dataset's decimal strings; average_allowed is rounded to integer USD cents. Rank is within the selected setting and metric, before filtering by code.

meta.source identifies the snapshot year, publication date, source URL, hash, dictionary URL, landing URL, and selection notes. Pagination uses page, limit, total, and nullable next_page.

Interpretation

An absent code means no matching observation in this snapshot; it does not mean zero services. The historical average is not today's reimbursement rate. Use rates for a current amount, and retain the utilization year and source when displaying rankings.

Request

GET

/api/v1/utilization

curl -G 'https://feebase.co/api/v1/utilization' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response

{
  "data": [
    {
      "code": "99214",
      "setting": "non_facility",
      "year": 2024,
      "rank": 1,
      "services": "1000.0",
      "beneficiaries": "750.0",
      "average_allowed": 12000,
      "currency": "usd",
      "source_row": 2
    }
  ],
  "meta": {
    "page": 1,
    "limit": 25,
    "total": 1,
    "next_page": null,
    "sort": "services",
    "source": {
      "year": 2024,
      "published": "2026-01-01",
      "source_url": "https://data.cms.gov/",
      "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
      "dictionary_url": "https://data.cms.gov/",
      "landing_url": "https://data.cms.gov/",
      "selection": "Illustrative documentation sample."
    }
  }
}

Illustrative response. Values and release IDs are examples.