# GET Get a customiser preview link

Returns a signed link that opens the customer customiser as shoppers see it, priced in the store's currency, including while the customiser is not live. The link needs no login, works only for this customiser, and stops working at `expires_at`, 30 minutes after it is issued: treat it as a secret and ask for a new one when it expires. `preset_id` opens one of the customiser's presets. `save_design_preview=true` shows the AI Sign Designer "Save my design" card, and `ai_sign_designer_preview=true` shows AI Sign Designer before it is switched on; the public storefront never shows either. An AI Sign Designer upload in the preview spends the store's AI credits as on the storefront, and `ai_sign_designer_preview` allows that while AI Sign Designer is off, so anyone with the link can spend credits until it expires. Read-only; requires `customisers:read`. A 404 problem means the customiser is not one of this store's. A 422 problem with code `invalid_parameter` names a `preset_id` that is not a preset of this customiser, or a mode that is not `true` or `false`.

- Source URL: https://www.signcustomiser.com/help/api/v3-get-get-a-customiser-preview-link/
- Markdown URL: https://www.signcustomiser.com/help/api/v3-get-get-a-customiser-preview-link.md
- Group: Customisers
- OpenAPI for this group: https://www.signcustomiser.com/help/openapi/customisers.json
- Method: GET
- Path: /api/v3/customisers/{customiser_id}/preview-url
- Auth: Bearer token
- Required scopes: `customisers:read`

## Path parameters

- customiser_id (string, required): The customiser id. Example: 1

## Query parameters

- preset_id (string, optional): A preset of this customiser, from the list presets operation. Example: 7
- save_design_preview (string, optional): `true` to show the "Save my design" card. Example: true
- ai_sign_designer_preview (string, optional): `true` to show AI Sign Designer before it is on. Example: true

## cURL example

```bash
curl https://web.signcustomiser.com/api/v3/customisers/1/preview-url?preset_id=7&save_design_preview=true&ai_sign_designer_preview=true \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
```

## Response examples

### 200 GET 200 example 1

```json
{
  "data": {
    "object": "customiser_preview_url",
    "customiser_id": 42,
    "url": "https://web.signcustomiser.com/preview/42/signed?currency_code=USD&expires=1789000000&signature=3f1c",
    "expires_at": "2026-11-16T09:30:00Z"
  },
  "links": {
    "self": "https://web.signcustomiser.com/api/v3/customisers/42/preview-url",
    "documentation": "https://www.signcustomiser.com/help/api/"
  },
  "meta": {
    "api_version": "v3",
    "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 customisers:read scope.",
  "required_scopes": [
    "customisers:read"
  ],
  "granted_scopes": [
    "store:read"
  ],
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```

### 404 Unknown customiser

```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 preset

```json
{
  "type": "https://www.signcustomiser.com/help/api/problems/invalid_parameter",
  "title": "Invalid query parameter",
  "status": 422,
  "code": "invalid_parameter",
  "detail": "preset_id is not a preset of this customiser.",
  "errors": [
    {
      "parameter": "preset_id",
      "code": "invalid_parameter",
      "detail": "preset_id is not a preset of this customiser."
    }
  ],
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```
