analytics

Preflight a market analysis: files, time, price

Resolve codes x geography x payers to the rate files that must be read (warm = already indexed; cold = indexed just in time), with the estimated time and price. Nothing is started.

Workflows

Workflow market-analysis, step 2/4 estimate: Aggregate rate statistics for services across insurers and all providers in an area (benchmarking, research, negotiation prep, exports).

  • Purpose: Preflight - files needed (warm vs cold), estimated seconds and usage charge, limit violations (a narrower scope removes them).
  • Call after: find_codes
  • Next: start_market_analysis
post/v1/analytics/estimate

Request

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

Request body

codesstring[] required

1-20 CPT/HCPCS codes from find_codes. Codes that hospitals are paid per APC also bring in the hospitals' APC case rates.

payersstring[]

Insurer names as people say them ("Premera", "Aetna", "Regence", "UnitedHealthcare", "Cigna", "Kaiser"), catalog payer ids, or ["major"] = the largest insurers in this market (major_payers of them).

major_payersinteger

How many insurers "major" means.

files_per_payerinteger

Most rate files read per insurer (in-area and most-used files first). More = more coverage, more first-time indexing (time, price).

index_new_filesboolean

false = read only files that are already indexed (fast, nearly free; coverage may be lower). true = also index the in-scope files that are not yet indexed.

providers'relevant' | 'all'

relevant = billing entities with evidence they provide the service (Medicare billing for the code, facility, hospital APC); all = also entities that merely hold a contracted rate.

include_providersboolean

Add the least / most expensive billing entities (name, TIN, site address, miles) to each result group.

providers_per_groupinteger
max_price_usdnumber nullable

Highest estimated usage charge (USD) the job may start with (default $1.00); above it the job is not started (409 price_confirmation_required).

Example request

{
  "geography": {
    "zip": "98052"
  }
}

Response

Successful Response

Open required

Changes

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