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

# List your designs

`GET /api/designs`

## Request

- Base URL: `https://api.crayonz.ai`
- URL: `https://api.crayonz.ai/api/designs`
- Auth: API key in header `X-API-Key`

Every print-ready design your key has generated, newest first, with its file_url, size, quality score, the idea it came from and the X-Crayonz-Tag it was made under. Free. GET /api/designs/{id} returns one design. Designs made before 12 Sep 2026 are not attributed.

## Query parameters

- `tag` string: Only designs made with this X-Crayonz-Tag
- `limit` integer: 1–200, default 50

## Response `200`

Success

- object
  - `status` string
  - `count` integer: Number of rows returned (bounded by limit)
  - `designs` object[]: id, file_url, width, height, quality_score, print_ready, cut_status, idea, source, tag, created_at — one row per design

## Other responses

- `401`: Unauthorized — invalid or missing API key
- `402`: Insufficient credits
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/crayonz/apis/crayonz-api.md) · [All operations](https://skmtc.dev/crayonz/apis/crayonz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crayonz/apis/crayonz-api/revisions/1114c84167b2?raw)