06
API Reference
Learn the conventions and patterns used across the Turquoise Consumer Pricing API, plus the
details, example requests, and responses for each endpoint. All endpoints are under base URL
https://api.turquoise.health and use JSON request and response bodies.
Conventions
- Auth
- Bearer token on every request
- Pagination
page_size+cursor→page.next_cursor- Money
- objects: integer
minor_units(cents),amount,currency - Search
search+min_scoreon list endpoints
Errors
400- Malformed parameters
401- Missing or expired token
404- Resource not found
422- Validation error
429- Rate limit; back off and retry
500- Server error
Endpoints
Click below to jump to the associated section
V3
- GET /v3/providers/types Get Provider Types
- GET /v3/providers List Providers
- GET /v3/providers/{provider_id} Get Provider Details
- GET /v3/payers List Payers
- GET /v3/payers/{payer_id} Get Payer Details
- GET /v3/networks List Networks
- GET /v3/networks/{network_id} Get Network Details
- GET /v3/packages List Packages
- GET /v3/packages/{package_id} Get Package Details
- GET /v3/packages/{package_id}/line_items List a Package's Contents
- POST /v3/prices/query List Prices
- POST /v3/prices/compare Get Price Statistics
- GET /v3/prices/{price_id} Get a Price
- POST /v3/personalized-estimates List personalized prices
- POST /v3/personalized-estimates/compare Compare personalized prices across providers for a package