List swipe files
Returns a paginated list of swipe files for the authenticated organization. Supports the same metadata filters as search, without a query. When ids is provided, returns only those swipe files and cursor pagination is ignored.
API key for authentication. Include in the X-API-Key header.
In: header
Query Parameters
Number of items to return (1-100, default 20)
201 <= value <= 100Comma-separated list of swipe file IDs to fetch. When provided, cursor pagination is ignored.
Cursor for pagination — ID of the last item from the previous page
Filter by ingest status
"processing" | "ready" | "failed"Filter by industry (Shopify L1 category). Repeat the parameter to match any of multiple industries.
Filter by ad format. Repeat the parameter to match any of multiple formats.
Filter by aspect ratio. Repeat the parameter to match any of multiple ratios.
When true, returns only archived swipe files. Defaults to false (active only). Managed designs cannot be archived, so the archived view only ever contains your own uploads.
"true" | "false"Comma-separated list of subscribed data source IDs to restrict managed designs to. Omit for all subscribed data sources; pass an empty value to exclude managed designs entirely.
Whether to include your organization's own uploads. Defaults to true.
"true" | "false"Response Body
curl -X GET "https://api.staticadslab.com/v1/swipe-files?limit=20&ids=sf_abc123%2Csf_def456&starting_after=sf_a1b2c3d4e5f67890&status=ready&industry=Apparel+%26+Accessories&ad_format=Sale&aspect_ratio=1%3A1&archived=true&data_source_ids=sfs_all_sal_ads&include_own=true"{
"data": [
{
"id": "sf_a1b2c3d4e5f67890",
"image_url": "https://cdn.staticadslab.com/swipe-files/sf_abc.png",
"thumbnail_url": "string",
"width": 1080,
"height": 1080,
"aspect_ratio": "1:1",
"industry": "Apparel & Accessories",
"ad_format": "Sale",
"source": "upload",
"is_managed": false,
"status": "ready",
"error": "string",
"created_at": "2026-07-03T12:00:00.000Z",
"updated_at": "2026-07-03T12:00:00.000Z"
}
],
"has_more": true,
"meta": {
"request_id": "req_a1b2c3d4e5f67890",
"timestamp": "2026-03-27T12:00:00.000Z"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request body",
"details": [
{
"field": "string",
"message": "string"
}
]
},
"meta": {
"request_id": "req_a1b2c3d4e5f67890",
"timestamp": "2026-03-27T12:00:00.000Z"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request body",
"details": [
{
"field": "string",
"message": "string"
}
]
},
"meta": {
"request_id": "req_a1b2c3d4e5f67890",
"timestamp": "2026-03-27T12:00:00.000Z"
}
}