---
title: "List cover pages"
method: GET
path: "/v3/projects/{projectId}/services/{id}/coverPages"
tags: ["Cover pages"]
---

# List cover pages

`GET /v3/projects/{projectId}/services/{id}/coverPages`

## Request

- Base URL: `https://fax.api.sinch.com`
- URL: `https://fax.api.sinch.com/v3/projects/{projectId}/services/{id}/coverPages`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://auth.sinch.com/oauth2/token`

Lists the cover pages on a service. To retrieve the cover page file, use the [Get a cover page](https://developers.sinch.com/docs/fax/api-reference/fax/cover-pages/getcoverpage) operation to download it.

## Response `200`

List of coverpages [Error](https://developers.sinch.com/docs/fax/api-reference/fax/error-messages)

- object
  - `coverPages` CoverPageInfo[]: List of cover pages
    - `id` string, ulid: ID of the cover page
    - `name` string: The friendly name of the cover page.
    - `projectId` string: The `Id` of the project associated with the call.
    - `serviceId` string: ID of the fax service used.
    - `createdTime` string, date-time: The date and time the cover page was created.
    - `updatedTime` string, date-time: The date and time the cover page was updated.
    - `createdAt` string, date-time: The timestamp on which the cover page was created.
    - `updatedAt` string, date-time: The timestamp on which the cover page was updated.
  - `page` integer: Current page
  - `totalPages` integer: Total number of pages.
  - `pageSize` integer: Number of items per page.
  - `totalItems` integer: Total size of the result.

## Changes

- **2026-10-21** `d3054d7412d5`: 3 breaking, 2 info
  - the response property `allOf[subschema #1]/coverPages/items/name` became optional for the status `200`
  - the `allOf[subschema #1]/coverPages/items/name` response's property type changed from no type to `string` for status `200`
  - removed the required property `allOf[subschema #1]/coverPages/items/file` from the response with the `200` status
  - added the optional property `allOf[subschema #1]/coverPages/items/createdAt` to the response with the `200` status
  - …1 more
- **2026-10-01** `7f5e54fa9f05`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sinch/apis/fax-api/changes/v3/projects/:projectId/services/:id/coverPages/get.md)

---

[API](https://skmtc.dev/sinch/apis/fax-api.md) - [All operations](https://skmtc.dev/sinch/apis/fax-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sinch/apis/fax-api/revisions/d3054d7412d5?raw)