---
title: "Get highlight"
method: GET
path: "/v1/highlights/{highlight_id}"
tags: ["Highlights"]
---

# Get highlight

`GET /v1/highlights/{highlight_id}`

Retrieve a single highlight by its unique identifier. Returns the highlight's text content, associated data entry, tags, and time range (for transcript highlights).

> 🚧 Permissions
>
> Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.

## Path parameters

- `highlight_id` string, required

## Response `200`

200

- object
  - `data` object, required
    - `id` string, required
    - `url` string, nullable — The URL of the parent note containing this highlight in the Dovetail web app. This field is experimental and may change without notice.
    - `note_id` string, nullable, required
    - `tags` object[], required
      - `id` string, required
      - `title` string, required
    - `text` string, nullable, required
    - `type` 'highlight', required
    - `start_time` number, nullable, required
    - `end_time` number, nullable, required
    - `created_at` string, required
    - `updated_at` string, required

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `422` — 422
- `429` — 429
- `500` — 500

---

[API](https://skmtc.net/dovetail/apis/dovetail-public-api.md) · [All operations](https://skmtc.net/dovetail/apis/dovetail-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dovetail/dovetail-public-api/versions/4107f5fdf8b2/schema)