---
title: "Get a list of favorites"
method: GET
path: "/me/favorites"
tags: ["favorites"]
---

# Get a list of favorites

`GET /me/favorites`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/me/favorites`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/me/favorites/get.ts> (a function with typed inputs; its response is checked against the schema)

Gets all favorites for the requesting user

## Request body `application/x-www-form-urlencoded`

- object
  - `since` integer: Retrieve favorites created/deleted since this date using UNIX timestamp.

## Response `200`

List of favorites for a given user

- ModelsFavorite[]
  - `billable` boolean
  - `client_name` string: Related entities meta fields - if requested
  - `created_at` string
  - `deleted_at` string
  - `description` string
  - `favorite_id` integer
  - `project_active` boolean
  - `project_color` string
  - `project_id` integer
  - `project_name` string
  - `public` boolean
  - `rank` integer
  - `tag_ids` integer[]: tag IDs are loaded into this after loading the Favorite
  - `task_id` integer
  - `task_name` string
  - `workspace_id` integer

## Other responses

- `403`: User has no access to Favorites feature
- `500`: Internal Server Error

---

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