Consumer Pricing

List Prices

Return prices for valid provider, service package, and pricing arrangement (cash or negotiated) combinations.

post/v3/prices/query

Request

  • Base URL: https://api.turquoise.health
  • URL: https://api.turquoise.health/v3/prices/query
  • Auth: HTTP bearer

Request body

package_idstring required
provider_idstring nullable
sort'total' | 'distance'

Sort options for price listings. distance requires a near/zip location.

sort_direction'asc' | 'desc'

Sort order. Defaults to ascending (lowest total / nearest first).

page_sizeinteger
cursorstring nullable

Example request

{
  "package_id": "R017Z",
  "provider_id": "5754",
  "pricing": {
    "network_id": "-3776001016975145508"
  },
  "location": {
    "near": {
      "lat": 39.746549,
      "lng": -104.966925,
      "radius_m": 25000
    },
    "within": {
      "state": "CO",
      "cbsa": "Denver-Aurora-Centennial, CO",
      "zip_codes": [
        "80218",
        "80210"
      ]
    },
    "zip": "80218"
  }
}

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": [
    {
      "id": "prc_5754.RA007.-3776001016975145508",
      "object": "price",
      "package": {
        "id": "R017Z",
        "name": "Ultrasound"
      },
      "pricing": {
        "network": {
          "id": "-3776001016975145508",
          "name": "National OAP"
        },
        "payer": {
          "id": "76",
          "name": "Cigna"
        },
        "type": "negotiated"
      },
      "provider": {
        "address": {
          "city": "Denver",
          "latitude": 39.746549,
          "longitude": -104.966925,
          "state": "CO",
          "zip_code": "80218"
        },
        "id": "5754",
        "name": "HCA HealthONE Presbyterian St Lukes",
        "npi": "1720038946",
        "object": "provider",
        "type": "Short Term Acute Care Hospital"
      },
      "total": {
        "amount": "526.10",
        "currency": "USD",
        "minor_units": 52610
      }
    }
  ]
}

Changes

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