---
title: "Get favorites"
method: GET
path: "/api/v1/projects/{projectUuid}/favorites"
tags: ["Content"]
---

# Get favorites

`GET /api/v1/projects/{projectUuid}/favorites`

Get the current user's favorite items in a project

## Path parameters

- `projectUuid` string, required

## Response `200`

Success

- ApiFavoriteItems
  - `results` union[], required
    - union
      - ResourceViewChartItem
        - `category` 'mostPopular' | 'recentlyUpdated' | 'pinned' | 'favorites' | 'verified'
        - `data` object, required — From T, pick a set of properties whose keys are in the union K
          - `name` string, required — Display name of the chart
          - `description` string — Optional description of what this chart displays
          - `slug` string, required — Unique identifier slug for this chart
          - `uuid` string, required
          - `chartKind` 'line' | 'horizontal_bar' | 'vertical_bar' | 'scatter' | 'area' | 'mixed' | 'pie' | 'table' | 'big_number' | 'funnel' | 'custom' | 'treemap' | 'gauge' | 'map' | 'sankey' | 'data_app_viz'
          - `pinnedListUuid` string, nullable, required
          - `pinnedListOrder` number, double, nullable, required
          - `verification` ContentVerificationInfo, required
            - `verifiedAt` string, date-time, required
            - `verifiedBy` object, required
              - …
          - `updatedAt` string, date-time, required — Timestamp when the chart was last updated
          - `updatedByUser` UpdatedByUser
            - `userUuid` string, required
            - `firstName` string, required
            - `lastName` string, required
          - `spaceUuid` string, required
          - `views` number, double, required
          - `firstViewedAt` union, required
            - string
            - string, date-time
          - `validationErrors` ValidationSummary[]
            - `createdAt` string, date-time, required
            - `error` string, required
            - `validationUuid` string, required
            - `validationId` number, double, nullable, required
          - `chartType` 'cartesian' | 'table' | 'big_number' | 'pie' | 'funnel' | 'treemap' | 'gauge' | 'custom' | 'map' | 'sankey' | 'data_app_viz'
          - `source` 'dbt_explore' | 'sql'
        - `type` 'chart', required
      - ResourceViewDashboardItem
        - `category` 'mostPopular' | 'recentlyUpdated' | 'pinned' | 'favorites' | 'verified'
        - `data` PickDashboardBasicDetailsUuidOrSpaceUuidOrDescriptionOrNameOrViewsOrFirstViewedAtOrPinnedListUuidOrPinnedListOrderOrUpdatedAtOrUpdatedByUserOrValidationErrorsOrVerification, required — From T, pick a set of properties whose keys are in the union K
          - `name` string, required
          - `description` string
          - `uuid` string, required
          - `pinnedListUuid` string, nullable, required
          - `pinnedListOrder` number, double, nullable, required
          - `verification` ContentVerificationInfo, required
            - `verifiedAt` string, date-time, required
            - `verifiedBy` object, required
              - …
          - `updatedAt` string, date-time, required
          - `updatedByUser` UpdatedByUser
            - `userUuid` string, required
            - `firstName` string, required
            - `lastName` string, required
          - `spaceUuid` string, required
          - `views` number, double, required
          - `firstViewedAt` union, required
            - string
            - string, date-time
          - `validationErrors` ValidationSummary[]
            - `createdAt` string, date-time, required
            - `error` string, required
            - `validationUuid` string, required
            - `validationId` number, double, nullable, required
        - `type` 'dashboard', required
      - ResourceViewSpaceItem
        - `data` object, required — From T, pick a set of properties whose keys are in the union K
          - `name` string, required
          - `uuid` string, required
          - `organizationUuid` string, required
          - `projectUuid` string, required
          - `inheritParentPermissions` boolean, required
          - `pinnedListUuid` string, nullable, required
          - `pinnedListOrder` number, double, nullable, required
          - `parentSpaceUuid` string, nullable, required
          - `path` string, required
          - `appCount` number, double, required
          - `childSpaceCount` number, double, required
          - `chartCount` number, double, required
          - `dashboardCount` number, double, required
          - `accessListLength` number, double, required
          - `access` string[], required
        - `type` 'space', required
      - ResourceViewDataAppItem
        - `category` 'mostPopular' | 'recentlyUpdated' | 'pinned' | 'favorites' | 'verified'
        - `data` object, required
          - `pinnedListOrder` number, double, nullable, required
          - `pinnedListUuid` string, nullable, required
          - `latestVersionStatus` 'pending' | 'sandbox' | 'catalog' | 'generating' | 'building' | 'packaging' | 'ready' | 'error', required
          - `latestVersionNumber` number, double, nullable, required
          - `firstViewedAt` string, date-time, nullable, required
          - `views` number, double, required
          - `updatedByUser` object, nullable, required
            - `lastName` string, required
            - `firstName` string, required
            - `userUuid` string, required
          - `updatedAt` string, date-time, required
          - `createdByUserUuid` string, nullable, required
          - `spaceUuid` string, nullable, required
          - `description` string
          - `name` string, required
          - `uuid` string, required
        - `type` 'data_app', required
  - `status` 'ok', required

## Other responses

- `default` — Error

---

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