For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
    • Overview
  • Runtype API
      • GETList generation sessions
      • POSTCreate a generation session
      • GETGet session details
      • DELDelete a generation session
      • PATCHUpdate a generation session
      • POSTAppend an event to a session
Dashboard
LogoLogo
Runtype APIProduct Generation

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.
Was this page helpful?
Previous

Create a generation session

Next
Built with

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