---
title: "Read all eligible published price variants in a paginated location catalog"
method: GET
path: "/entities/{slug}/price-catalog"
---

# Read all eligible published price variants in a paginated location catalog

`GET /entities/{slug}/price-catalog`

## Request

- Base URL: `https://www.loacare.com/api/v1`
- URL: `https://www.loacare.com/api/v1/entities/{slug}/price-catalog`
- Auth: one of:
  - none
  - API key in header `x-api-key`

Anonymous read access. JSON, readable HTML, or CSV per page. Current records, not an immutable snapshot or complete hospital MRF. Follow pagination.next or the Link header; preserve code/type filters. Ordered by service code, cash first, then amount. Service choices and counts use the same publication filters. Original hospital wording and source files are not available. Description labels come from Loa code mappings or reviewed provider submissions.

## Path parameters

- `slug` string, required

## Query parameters

- `type` 'hospital' | 'provider', required
- `format` 'json' | 'csv' | 'html'
- `code` string
- `limit` integer
- `after` string

## Response `200`

Catalog page; Link rel=next when another page exists. CSV includes next_cursor and catalog_notes.

- object
  - `schema_version` '2', required
  - `entity` object, required
  - `prices` object[], required
  - `pagination` object, required
    - `limit` integer
    - `returned` integer
    - `next_cursor` string, nullable
    - `next` string, nullable
  - `notes` string[], required
  - `services` object[], required
  - `selected_service` string, nullable, required

## Other responses

- `400`: Invalid catalog query or cursor.
- `401`: Invalid API key.
- `403`: API key scope denied.
- `404`: Published location not found.
- `429`: Rate limit exceeded.
- `503`: Catalog temporarily unavailable.

## Changes

- **2026-11-18** `7060616e6a94`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/loacare/apis/loa-healthcare-pricing-api/changes/entities/:slug/price-catalog/get.md)

---

[API](https://skmtc.dev/loacare/apis/loa-healthcare-pricing-api.md) - [All operations](https://skmtc.dev/loacare/apis/loa-healthcare-pricing-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loacare/apis/loa-healthcare-pricing-api/revisions/7060616e6a94?raw)
