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

# List books

`GET /v1/books`

List all books the authenticated user has access to

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

successful

- object
  - `data` Book[], required
    - `id` string, required — The ID of the book
    - `name` string, required — The name of the book
    - `role` 'principal' | 'contributor' | 'viewer', nullable, required — The authenticated user's role in this book. Null for admin users accessing books without an explicit BookUser record.
    - `users` BookUser[], required — Users with access to this book
      - `id` string, required — The ID of the user
      - `email` string, email, required — Email address of the user
      - `first_name` string, nullable, required — First name of the user
      - `last_name` string, nullable, required — Last name of the user
      - `api_access` object — Authentication details for the current personal access token. Only present on /v1/me when authenticating with a PAT.
        - `auth_type` 'personal_access_token'
        - `scope` 'read_only' | 'read_write'
      - `role` 'principal' | 'contributor' | 'viewer', required — The user's role in this book
    - `tiers` object[], required — Available tier labels for households in this book
      - `value` integer, required — Numeric tier value
      - `label` string, required — Display label for the tier
    - `teams` object[], required — Teams in the book's company
      - `id` string, required — Team ID
      - `name` string, required — Team name
  - `pagination` object, required
    - `current_page` integer
    - `total_pages` integer
    - `total_count` integer
    - `per_page` integer

## Other responses

- `400` — bad request - invalid JSON
- `401` — unauthorized - missing or invalid token
- `403` — forbidden

---

[API](https://skmtc.net/slant/apis/slant-public-api-v1.md) · [All operations](https://skmtc.net/slant/apis/slant-public-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slant/slant-public-api-v1/revisions/b56e0d137554/schema)