---
title: "Retrieve all favorites"
method: GET
path: "/v2/favorites"
---

# Retrieve all favorites

`GET /v2/favorites`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/favorites`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/favorites/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to get the list of documents and document groups marked as favorites.

## Response `200`

List of documents and document groups the user added to favorites.

- object
  - `data` object[]: Favorite items.
    - `id` string: ID of the document or document group.
    - `entity_type` string: Type of the item: `document` or `document-group`.
  - `meta` object: Pagination details.
    - `pagination` object: Pagination information for the result set.
      - `count` integer: Number of items on the current page.
      - `links` object: Links to the adjacent pages. An empty array when there are no other pages; otherwise an object with `next` and/or `previous` URLs.
      - `total` integer: Total number of items.
      - `per_page` integer: Maximum number of items per page.
      - `total_pages` integer: Total number of pages.
      - `current_page` integer: Number of the current page.

## Other responses

- `400`: * Request with incorrect or missing token. * Request with incorrect query string.

---

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