---
title: "List designs"
method: GET
path: "/designs"
tags: ["Designs"]
---

# List designs

`GET /designs`

## Request

- Base URL: `https://services.certseal.com/api/v1`
- URL: `https://services.certseal.com/api/v1/designs`
- Auth: HTTP bearer

Returns designs in the API key's workspace, newest first. Read-only:
designs are authored in the CertSeal web app. Use this to populate a
design picker when creating a batch.

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

A page of designs.

- object
  - `designs` Design[], required
    - `id` string, required
    - `name` string, required
    - `orientation` string, required: One of `landscape`, `portrait`, or `square`.
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `pagination` Pagination, required
    - `nextCursor` string, nullable, required: Pass this as `?cursor=` to fetch the next page. `null` when you've reached the last page.
    - `hasMore` boolean, required: True when more pages remain.

## Other responses

- `401`: Missing, malformed, expired, or revoked API key.
- `429`: Too many requests for this API key. Honour the `Retry-After` response header (seconds) or the `detail.retryAfter` field.

---

[API](https://skmtc.dev/certseal/apis/certseal-com-api.md) · [All operations](https://skmtc.dev/certseal/apis/certseal-com-api/llms.txt) · [OpenAPI document](https://skmtc.dev/certseal/apis/certseal-com-api/revisions/9097f49f49f5?raw)