---
title: "List catalog prices"
method: GET
path: "/catalog/prices"
tags: ["catalog"]
---

# List catalog prices

`GET /catalog/prices`

Returns a paginated list of catalog prices, filterable by company, catalog entry, location, effective date, and price type.

## Query parameters

- `ottimate_company_id` integer
- `catalog_entry_id` string
- `ottimate_location_id` integer
- `effective_date` string, date
- `price_type` 'company' | 'location_group' | 'location'
- `page` integer
- `limit` integer

## Headers

- `Authorization` string, required
- `X-Api-Key` string, required
- `X-API-Version` string

## Response `200`

Successful response with paginated price list

- CatalogGetCatalogPricesResponse200 — Paginated list of catalog prices
  - `count` integer, required
  - `page` integer
  - `per_page` integer
  - `results` CatalogPriceItem[], required
    - `id` string, required — Price ID
    - `catalog_entry_id` string — Catalog entry ID
    - `ottimate_company_id` integer — Company ID
    - `price` string, required — Price amount (decimal string)
    - `unit_price` string — Unit price (decimal string)
    - `price_type` integer, required — Price type
    - `price_type_display` 'company' | 'location_group' | 'location' — Human-readable price type
    - `ottimate_location_id` integer — Location ID
    - `ottimate_group_id` integer — Location group ID
    - `start_date` string, date, required — Price start date. Date-only (e.g. "2026-07-24").
    - `end_date` string, date — Price end date. Date-only (e.g. "2126-07-24"). Defaults to 36,500 days (~100 years) after start_date when not supplied at creation, rather than staying null.
    - `reference_id` string — Unique key
    - `created_date` string, date-time — Record creation date
    - `created_date_utc` string, date-time, nullable — UTC equivalent of created_date. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z".
    - `last_modified_date` string, date-time — Record last modified date
    - `last_modified_date_utc` string, date-time, nullable — UTC equivalent of last_modified_date. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z".

## Other responses

- `400` — Bad request - Invalid parameters or request format
- `403` — Forbidden - Access denied or insufficient permissions

---

[API](https://skmtc.dev/ottimate/apis/api-reference.md) · [All operations](https://skmtc.dev/ottimate/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ottimate/api-reference/revisions/ba91ff4c6969/schema)