---
title: "GET /personal/users/{userId}/bookmarks"
method: GET
path: "/personal/users/{userId}/bookmarks"
tags: ["personal-bookmarks"]
---

# GET /personal/users/{userId}/bookmarks

`GET /personal/users/{userId}/bookmarks`

Returns list of user's bookmarks - might be filtered by query text (`q` with `limit`) > `location` > `orderBy parameters;
The parameters precedence is shown via **>**
`page` and `limit` query parameters are used for pagination - if missing default values are used.

## Path parameters

- `userId` string, required

## Query parameters

- `q` string
- `page` integer
- `limit` integer
- `location` string
- `orderBy` 'MOST_LIKES' | 'LAST_CREATED' | 'MOST_USED'

## Response `200`

List of bookmarks

- Bookmark[]
  - `_id` string
  - `name` string, required
  - `location` string, required
  - `language` string, required
  - `tags` string[], required
  - `description` string
  - `descriptionHtml` string
  - `updatedAt` string, date-time
  - `createdAt` string, date-time
  - `lastAccessedAt` string, date-time
  - `publishedOn` string, date
  - `public` boolean
  - `userId` string, required
  - `likeCount` number
  - `sourceCodeURL` string
  - `ownerVisitCount` number
  - `youtubeVideoId` string
  - `stackoverflowQuestionId` string

## Other responses

- `401` — unauthorized (you need to have a valid token) and userId must match the subject in token
- `403` — Access token is missing or invalid

---

[API](https://skmtc.net/codeverdotdev/apis/codever-api.md) · [All operations](https://skmtc.net/codeverdotdev/apis/codever-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/codeverdotdev/codever-api/versions/479a3dd64e1f/schema)