Designs
Get designs
Use this endpoint to retrieve a paginated list of the account’s swag designs, newest first. Every design includes its tags.
Filtering options
filter[search]- case-insensitive search on the design namefilter[tag]- comma-separated list of tag names (up to 20). Returns designs that have any of the tags, case-insensitiveSnappy-Account-Idheader - required account identifier
Optional parameters
page[number]/page[size]- page-number pagination (1-indexed; max 100 per page, default 100)
Please note
- Designs are always sorted newest first.
sortis not supported. - Designs that are still being generated are not returned.
- A tag that no design has is not an error: it matches no designs.
- Unknown query parameters return a 400 error.
Permissions
- Requires:
swag:designs:read
GET
Get designs
Authorizations
Company Level Authentication
Include your API key in the X-Api-Key header for every request:
Headers
Required. Account identifier.
Minimum string length:
1Example:
"acc123456"
Query Parameters
Case-insensitive search on the design name (1-100 characters).
Required string length:
1 - 100Example:
"Summit"
Comma-separated list of tag names (1-20 names, each 1-50 characters). Returns designs that have any of the tags. Matching is case-insensitive.
Required string length:
1 - 50Example:
1-indexed page number.
Required range:
x >= 1Example:
1
Number of designs per page (max 100, default 100).
Required range:
1 <= x <= 100Example:
100
Response
Paginated list of designs.
Paginated design list response (page-number pagination).
Last modified on November 11, 2026