# GET List the AI designs of a quote

Lists the AI designs linked to one quote of the store: the designs made from the quote's files in the merchant admin or with this API, and the design a "Save design form" submission saved. `quote_file` names the quote file a design was made from, as the `field_id` and `file_index` of the quote's `files`; it is null for a saved design. Newest first, with cursor pagination. Requires `ai_sign_designs:read` and `quotes:read`: the quote belongs to the quotes resource. Another store's quote and an unknown id answer the same 404. An erased design is not listed.

- Source URL: https://www.signcustomiser.com/help/api/v3-get-list-the-ai-designs-of-a-quote/
- Markdown URL: https://www.signcustomiser.com/help/api/v3-get-list-the-ai-designs-of-a-quote.md
- Group: AI sign designs
- OpenAPI for this group: https://www.signcustomiser.com/help/openapi/ai-sign-designs.json
- Method: GET
- Path: /api/v3/quotes/{quote_id}/ai-designs
- Auth: Bearer token
- Required scopes: `quotes:read`

## Path parameters

- quote_id (string, required): The submission id, from the list quotes operation. Example: 8123

## Query parameters

- limit (string, optional): Page size from 1 to 100. Defaults to 20. Example: 20
- cursor (string, optional): The opaque next_cursor from a previous page. Example: eyJ2IjoxfQ

## cURL example

```bash
curl https://web.signcustomiser.com/api/v3/quotes/8123/ai-designs?limit=20&cursor=eyJ2IjoxfQ \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
```

## Response examples

### 200 GET 200 example 1

```json
{
  "data": [
    {
      "object": "ai_design",
      "id": 51234,
      "origin": "quote",
      "status": "delivered",
      "product_family": "neon",
      "customiser_id": 42,
      "files": [
        {
          "kind": "svg",
          "purpose": "design",
          "media_type": "image/svg+xml",
          "access": "private",
          "url": "https://web.signcustomiser.com/api/v3/ai-designs/51234/files/svg",
          "download_url": null
        },
        {
          "kind": "eps",
          "purpose": "manufacturing_export",
          "media_type": "application/postscript",
          "access": "private",
          "url": "https://web.signcustomiser.com/api/v3/ai-designs/51234/files/eps",
          "download_url": null
        },
        {
          "kind": "illustrator_pdf",
          "purpose": "manufacturing_export",
          "media_type": "application/pdf",
          "access": "private",
          "url": "https://web.signcustomiser.com/api/v3/ai-designs/51234/files/illustrator_pdf",
          "download_url": null
        },
        {
          "kind": "raster_preview",
          "purpose": "preview",
          "media_type": "image/png",
          "access": "private",
          "url": "https://web.signcustomiser.com/api/v3/ai-designs/51234/files/raster_preview",
          "download_url": null
        },
        {
          "kind": "source",
          "purpose": "source",
          "media_type": "image/png",
          "access": "private",
          "url": "https://web.signcustomiser.com/api/v3/ai-designs/51234/files/source",
          "download_url": null
        },
        {
          "kind": "source_preview",
          "purpose": "source",
          "media_type": "image/png",
          "access": "private",
          "url": "https://web.signcustomiser.com/api/v3/ai-designs/51234/files/source_preview",
          "download_url": null
        }
      ],
      "product_ids": [
        90211
      ],
      "order_ids": [
        123
      ],
      "quote_id": 8123,
      "quote_file": {
        "field_id": "field_artwork",
        "file_index": 0
      },
      "ai_sign_design_job_id": null,
      "feedback_rating": "thumbs_up",
      "created_at": "2026-10-20T09:32:00Z"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  },
  "links": {
    "self": "https://web.signcustomiser.com/api/v3/quotes/8123/ai-designs",
    "documentation": "https://www.signcustomiser.com/help/api/",
    "next": null
  },
  "meta": {
    "api_version": "v3",
    "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
  }
}
```

### 401 Missing API key

```json
{
  "type": "https://www.signcustomiser.com/help/api/problems/missing_api_key",
  "title": "Missing API key",
  "status": 401,
  "code": "missing_api_key",
  "detail": "Provide a store API key as a bearer token.",
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```

### 403 Insufficient scope

```json
{
  "type": "https://www.signcustomiser.com/help/api/problems/insufficient_scope",
  "title": "Insufficient scope",
  "status": 403,
  "code": "insufficient_scope",
  "detail": "This operation requires the quotes:read scope, but the API key grants the following scopes: ai_sign_designs:read. Create a key that includes the required scope in the merchant admin under Integrate → API Tokens.",
  "required_scopes": [
    "quotes:read"
  ],
  "granted_scopes": [
    "ai_sign_designs:read"
  ],
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```

### 404 Unknown quote

```json
{
  "type": "https://www.signcustomiser.com/help/api/problems/resource_not_found",
  "title": "Resource not found",
  "status": 404,
  "code": "resource_not_found",
  "detail": "The requested resource does not exist or does not belong to the authenticated store.",
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```

### 422 Unknown parameter

```json
{
  "type": "https://www.signcustomiser.com/help/api/problems/unknown_parameter",
  "title": "Unknown query parameter",
  "status": 422,
  "code": "unknown_parameter",
  "detail": "This endpoint accepts only these query parameters: limit, cursor.",
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```

### 429 Rate limited

```json
{
  "type": "https://www.signcustomiser.com/help/api/problems/rate_limited",
  "title": "Too many requests",
  "status": 429,
  "code": "rate_limited",
  "detail": "You have exceeded the request limit for this API key.",
  "retry_after": 60,
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```
