---
title: "List signed links"
method: GET
path: "/v1/signed-links"
tags: ["Signed links"]
---

# List signed links

`GET /v1/signed-links`

## Request

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

Image links that render a template straight from a URL. Secrets are never returned by a read.

## Response `200`

Every object in the workspace (a single page today).

- SignedLinkList: Cursor-pagination envelope. Management lists are single-page today.
  - `data` SignedLink[], required
    - `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
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `object` string

## 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.
- `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)
