> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tattoo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List Designs

> Authenticated creative read-beta endpoint returning public design projections.

<Note>
  **Posture:** Authenticated internal beta. The caller must resolve to a mapped TattooAPI actor before access is granted.
</Note>

<Warning>
  **Write boundary:** Public writes are blocked. Do not build production flows assuming mutation is live on this route family.
</Warning>

Canonical request URL: `https://api.tattooapi.com/api/v1/designs`.

# List Designs

`GET /designs` is an authenticated read-beta endpoint.

It returns public design projections only. Private, draft, and owner-only creative records are not included.

## Auth

```bash theme={"dark"}
curl "$TATTOO_API_BASE_URL/designs?search=dragon&limit=20" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

## Query Parameters

| Parameter                | Type    | Notes                                          |
| ------------------------ | ------- | ---------------------------------------------- |
| `page`                   | integer | Default `1`                                    |
| `limit`                  | integer | Default `20`, max `100`                        |
| `artist_id`              | string  | Filter by runtime artist id                    |
| `style_id`               | string  | Filter by style id                             |
| `public`                 | boolean | `false` returns no records on the public route |
| `tags`                   | string  | Comma-separated tag filter                     |
| `search`                 | string  | Title and description search                   |
| `min_price`, `max_price` | number  | Optional price filters when price exists       |

## Response Shape

```json theme={"dark"}
{
  "success": true,
  "data": [
    {
      "id": "design:ashlewis-instagram-overlay-2026-04-20",
      "title": "Black and grey healed sleeve",
      "image_url": "https://example.com/image.jpg",
      "artist_id": "artist:example",
      "tags": ["black_and_grey"],
      "is_public": true,
      "publish_state": "published_public",
      "provenance": {},
      "trust": {},
      "runtime_trust_proof": {}
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  }
}
```

## Write Boundary

`POST`, `PUT`, `PATCH`, and `DELETE` are explicitly blocked on this public route family.

Design mutation belongs in a future owner-scoped contract, not the public route.