---
title: "Retrieve a share link"
method: GET
path: "/{id}"
---

# Retrieve a share link

`GET /{id}`

## Request

- Base URL: `https://marklayer.app/api`
- URL: `https://marklayer.app/api/{id}`
- Auth: none declared

## Path parameters

- `id` string, required: Unguessable share id (nanoid/uuid) — it is the access token

## Response `200`

Annotation payload

- Annotation
  - `ops` unknown[], required
    - unknown
  - `url` string, nullable, required
  - `width` number, nullable, required

## Other responses

- `401`: Password-protected link: send `Authorization: Bearer <password>`
- `404`: Not found
- `410`: Expired
- `429`: Too many wrong passwords for this link from this client

---

[API](https://skmtc.dev/marklayer/apis/marklayer-share-api.md) · [All operations](https://skmtc.dev/marklayer/apis/marklayer-share-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marklayer/apis/marklayer-share-api/revisions/0d8cd55afad9?raw)