---
title: "List wraps"
method: GET
path: "/api/v1/wraps"
tags: ["Wraps"]
---

# List wraps

`GET /api/v1/wraps`

## Request

- Base URL: `https://beyourcover.com`
- URL: `https://beyourcover.com/api/v1/wraps`
- Auth: HTTP bearer

Lists the wraps owned by the API key's account, newest first, with keyset cursor pagination: all of them, or one book's (`bookId`) or one cover's (`coverId`). Wraps made in the browser wrap editor are listed too, Amazon KDP and Barnes & Noble designs alike. Metadata only: read a wrap's text and signed asset links with `GET /api/v1/wraps/{wrapId}`. Free.

## Query parameters

- `bookId` string, uuid
- `coverId` string, uuid
- `limit` integer
- `cursor` string

## Response `200`

One page of wraps.

- WrapList
  - `wraps` WrapSummary[], required: Newest first.
    - `wrapId` string, uuid, required
    - `bookId` string, uuid, required
    - `coverId` string, uuid, nullable: Public id of the cover used as the front panel; null when it cannot be resolved to a cover on a book this account owns.
    - `designName` string, nullable: `API` for wraps created through `POST /api/v1/wraps`.
    - `designStyle` string, nullable
    - `printProvider` 'kdp' | 'bn', required
    - `bindingType` 'paperback' | 'hardcover' | 'dust-jacket', required
    - `trimWidth` number
    - `trimHeight` number
    - `pageCount` integer, nullable: Null on a Barnes & Noble design.
    - `paperType` string, nullable
    - `spineWidth` number
    - `flapWidth` number, nullable: Barnes & Noble dust jackets only.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `next_cursor` string, nullable, required: Pass as `cursor` to fetch the next page. `null` when there are no more results.

## Other responses

- `400`: `code` is one of: `invalid_limit`, `invalid_cursor`.
- `401`: Missing/malformed API key, unknown or inactive key, or inactive subscription detected during credit checks. `code`: `unauthorized`.
- `403`: The API key is valid but its owner has no active enterprise subscription. `code`: `forbidden`.
- `404`: `bookId` or `coverId` is not found or not owned by this API key's user. `code` is `book_not_found` or `cover_not_found`.
- `500`: Server error. `code` is `fetch_failed` or `internal_error`.

---

[API](https://skmtc.dev/beyourcover/apis/beyourcover-partner-api.md) · [All operations](https://skmtc.dev/beyourcover/apis/beyourcover-partner-api/llms.txt) · [OpenAPI document](https://skmtc.dev/beyourcover/apis/beyourcover-partner-api/revisions/82ad2c7c8ede?raw)