Consumer Pricing

List Packages

Return a list of service packages, filtered over name or anchor code. Additionally, filter to a list of packages with Turquoise price estimates available by a selected payer, network, or provider. Results reflect provider, payer, and package combinations that Turquoise has priced services for; the list may not be comprehensive of all payer networks or providers that support this service. When multiple relationship filters are combined, they must be satisfied by the same price row, so results are always fulfillable via GET /v3/prices.

get/v3/packages

Request

Base URL: https://api.turquoise.health
URL: https://api.turquoise.health/v3/packages
Auth: HTTP bearer

Query parameters

namestring nullable

Case-insensitive substring match on package name.

Example:ultrasound

anchor_codestring nullable

Billing code lookup; matches against anchor_codes[].code (package base codes only). Returns every package anchored by the code — exactly one in the current catalog, but uniqueness is not contractual (an anchor's full upstream identity includes revenue code and billing class, which this API collapses).

Example:76641

provider_idstring nullable

Packages priced at this provider.

Example:5754

network_idstring nullable

Packages with at least one price under this network (combined with provider_id/payer_id, the same price row must match).

Example:-3776001016975145508

payer_idstring nullable

Packages priced under any of this payer's networks (combined with other relationship filters, the same price row must match).

Example:76

searchstring nullable

Semantic search over package name and description. Composes with the other filters; returns a single relevance-ordered page (no cursor). 503 search_unavailable when the embedding index is not populated.

Example:breast ultrasound

min_scorenumber nullable

Minimum similarity score (0-1).

page_sizeinteger

cursorstring nullable

Opaque cursor from a previous page.next_cursor.

Response

Successful Response

object'list'

no_data_reason'no_data' | 'permission_denied'

disclosuresstring[]

Human-readable caveats about what this result does and does not imply.

Example response

{
  "items": [
    {
      "anchor_codes": [
        {
          "code": "76641",
          "code_type": "HCPCS"
        },
        {
          "code": "76642",
          "code_type": "HCPCS"
        }
      ],
      "description": "An ultrasound uses high-frequency sound waves to create real-time images of internal organs, tissues, and blood flow. This painless outpatient test requires no radiation and no needles. A technician applies gel to your skin and moves a small probe, instantly showing images on a screen. The procedure takes 15-45 minutes depending on what's being evaluated. Ultrasound safely evaluates pregnancy, organs, blood vessels, joints, and soft tissues. Results guide diagnosis and treatment planning. You go home immediately and can resume all activities. This estimate is based on the most common variation of this service, a breast ultrasound. Your price may differ depending on the type of ultrasound you have.",
      "disclosures": [
        "The full package depends on your provider and insurance plan. A final price includes additional institutional and professional fee codes."
      ],
      "id": "R017Z",
      "name": "Ultrasound",
      "object": "package",
      "type": "ssp_grouper"
    }
  ]
}

Changes

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