---
title: "List price books"
method: GET
path: "/v1/price-books"
tags: ["Price books"]
---

# List price books

`GET /v1/price-books`

Retrieve existing price books.

## Query parameters

- `take` number, nullable
- `skip` number, nullable

## Response `200`

- PaginatedPriceBook
  - `meta` object, required
    - `total` number, required — Total of existing items.
    - `taken` number, required — Number of items returned.
    - `skipped` number, required — Number of items skipped.
  - `data` PriceBook[], required — List of PriceBook.
    - `id` string, required — Price book ID.
    - `name` string, required — Price book name.
    - `description` string, nullable, required — Price book description.
    - `user_role_ids` string[], required — List of user role IDs that have access to this price book.
    - `created_at` string, date-time, required — Price book creation date. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `updated_at` string, date-time, required — Price book last update date. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.

---

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