rates

Negotiated rates for codes near a place

Coverage × codes × providers-or-area → self-describing rate rows + summary. First use of a plan's rate files indexes them just in time (up to wait_seconds); later calls are fast.

Workflows

Workflow compare-places, step 3/3 rates: Compare what the plan pays different nearby providers for the same service.

  • Purpose: Rows are comparable within the same billing component and place of service; a global rate already includes 26 + TC.
  • Call after: find_codes
post/v1/rates

Request

  • Base URL: https://api.ticexplorer.com
  • URL: https://api.ticexplorer.com/v1/rates
  • Auth: HTTP bearer

Request body

codesstring[] required

Billing codes from find_codes (CPT/HCPCS, or an APC number for hospital case rates).

limitinteger
cursorinteger

Pagination cursor from next_cursor.

wait_secondsinteger

How long to wait for rate files being indexed for the first time.

labelstring nullable

Echoed back in batch results.

Example request

{
  "area": {
    "zip": "98052"
  }
}

Response

Successful Response

next_cursorinteger nullable
total_rowsinteger required
summaryobject[]
cheapest_sitesobject[]

Per code x component: the cheapest real places to go (site, address, miles to the site, TIN, amount, quality).

hospital_file_checkobject nullable

How many hospital rows were compared with the hospitals' own price files, and how many agree.

medicare_referenceobject nullable

coverage medicare: per code OPPS wage-adjusted APC, estimated lab fee, ASP drug limit.

coverageobject nullable
next_stepsstring[]

Changes

No recorded changes to this operation across all 1 revision of this API.