# List favorites

List favorite items for a user, optionally filtered by type and search query.

Endpoint: GET /v2/users/{userId}/favorites
Version: v2
Security: Bearer

## Security:

  - `Bearer` (unknown)
    http bearer

## Path parameters:

  - `userId` (string, required)
    Identifier for user.

## Query parameters:

  - `types` (array)
    Filter by favorite types. If empty, returns all types.

  - `query` (string)
    Search query to filter favorites by display name.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `favorites` (array)

  - `favorites.favorite` (object)
    A single favorite item.

  - `favorites.favorite.favoriteId` (string)
    Unique identifier for the favorite item.

  - `favorites.favorite.type` (string)
    The type of favorite.

  - `favorites.favorite.params` (object)
    Key-value pairs of parameters for the favorite.

  - `favorites.favorite.displayName` (string)
    Display name for the favorite item.

  - `favorites.favorite.createdAt` (string)
    Timestamp when the favorite was created.

  - `favorites.type` (string)
    The type of favorite.

  - `favorites.url` (string)
    The URL for this favorite.

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `debugIdentifier` (string)
    Link to debug the error internally.

  - `errorMessages` (array)

  - `errorMessages.errorCode` (string)
    Error code to identify the specific errors.

  - `errorMessages.message` (string)
    Message containing details of error.

  - `errorMessages.errorParameters` (array)
    Error message parameters.

  - `errorMessages.errorParameters.name` (string)
    Parameter name

  - `errorMessages.errorParameters.value` (string)
    Parameter value

  - `errorMessages.errorDetail` (string)
    More details about the error.

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 fields (application/json):

  - `debugIdentifier` (string)
    Link to debug the error internally.

  - `errorMessages` (array)

  - `errorMessages.errorCode` (string)
    Error code to identify the specific errors.

  - `errorMessages.message` (string)
    Message containing details of error.

  - `errorMessages.errorParameters` (array)
    Error message parameters.

  - `errorMessages.errorParameters.name` (string)
    Parameter name

  - `errorMessages.errorParameters.value` (string)
    Parameter value

  - `errorMessages.errorDetail` (string)
    More details about the error.