---
title: "Retrieve a signed link"
method: GET
path: "/v1/signed-links/{link_id}"
tags: ["Signed links"]
---

# Retrieve a signed link

`GET /v1/signed-links/{link_id}`

## Request

- Base URL: `https://api-eu.dynamicdocumentapi.com`
- URL: `https://api-eu.dynamicdocumentapi.com/v1/signed-links/{link_id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Common base: API key or OAuth only, never a dashboard region token.

## Path parameters

- `link_id` string, required

## Response `200`

- SignedLink
  - `access` 'signed' | 'open', required: * `signed` - signed * `open` - open
  - `allowed_params` string[], required
  - `allowed_referrers` string[], nullable, required
  - `base_url` string, uri, required: Append `/{any-name}.{ext}?…` and a signature.
  - `cache_ttl_seconds` integer, nullable, required
  - `created_at` string, date-time, required
  - `defaults` object, required: Parameter values used when the URL omits them.
  - `enabled` boolean, required
  - `expires_at` string, date-time, nullable, required
  - `fallback_image_asset_id` string, nullable, required: `ast_…`: image served instead of 402 `render_limit_reached`.
  - `formats` string[], required
  - `id` string, required: `lnk_…`
  - `name` string, required
  - `object` string
  - `param_limits` object, required: e.g. `{"title.text": {"max_length": 80}}`.
  - `quota_total` integer, nullable, required
  - `quota_used` integer, required
  - `rate_limit_per_ip_per_hour` integer, nullable, required
  - `template_id` string, required

## Other responses

- `401`: Missing, invalid, expired or revoked credentials.
- `403`: Insufficient scope, IP not allowed, workspace suspended or scheduled for deletion, or email not verified.
- `404`: Signed link not found.
- `429`: Rate limited (`Retry-After`).
- `503`: The control plane is unreachable (`Retry-After`).

---

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