List generation sessions

GET

/v1/products/generation/sessions

GET

/v1/products/generation/sessions

$ curl https://api.runtype.com/v1/products/generation/sessions \
>      -H "Authorization: <apiKey>" \
>      -H "Content-Type: application/json"

1 {
2   "data": [
3     {
4       "assemblyState": {
5         "step": "assembling",
6         "progress": 75,
7         "details": "Combining generated assets"
8       },
9       "catalogVersion": "v2.4.1",
10       "createdAt": "2024-06-10T09:15:30Z",
11       "expiresAt": "2024-07-10T09:15:30Z",
12       "id": "a3f1c9d2-7b4e-4f8a-9c3d-2e5b7f6a1d9e",
13       "organizationId": "org_9f8b7c6d5e4a3b2c",
14       "plan": {
15         "name": "Pro Plan",
16         "features": [
17           "unlimited generations",
18           "priority support"
19         ],
20         "price": 49.99,
21         "currency": "USD"
22       },
23       "prd": {
24         "productId": "prd_1234567890",
25         "name": "AI Image Generator",
26         "version": "1.3.0"
27       },
28       "productObject": {
29         "type": "image_generation",
30         "parameters": {
31           "resolution": "1024x1024",
32           "style": "photorealistic",
33           "seed": 987654321
34         }
35       },
36       "productObjectHash": "d41d8cd98f00b204e9800998ecf8427e",
37       "schemaVersion": "1.0.0",
38       "status": "intake",
39       "updatedAt": "2024-06-10T09:45:00Z",
40       "userId": "user_5a6b7c8d9e0f1a2b"
41     }
42   ],
43   "pagination": {
44     "limit": 20,
45     "offset": 0,
46     "total": 125
47   }
48 }

Returns a paginated list of generation sessions for the authenticated user, optionally filtered by status.

Authentication

AuthorizationBearer

API key or Clerk session token

Query parameters

statusstringOptional

Filter by session status

limitstringOptional

Max results per page (default 20, max 100)

offsetstringOptional

Offset for pagination

Response

List of sessions with pagination

datalist of objects

paginationobject

Errors

401

Unauthorized Error

500

Internal Server Error