List collections

GET

/v1/collections

GET

/v1/collections

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

1 {
2   "data": [
3     {
4       "createdAt": "2024-05-10T09:15:00Z",
5       "description": "Collection of user feedback records from the mobile app.",
6       "displayName": "User Feedback",
7       "icon": "📝",
8       "id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
9       "indexedFields": [
10         "userId",
11         "submittedAt",
12         "rating"
13       ],
14       "schema": {
15         "userId": "string",
16         "submittedAt": "string",
17         "rating": "number",
18         "comments": "string"
19       },
20       "schemaVersion": 3,
21       "slug": "user-feedback",
22       "updatedAt": "2024-06-01T12:00:00Z",
23       "validationMode": "enforce",
24       "recordCount": 245
25     }
26   ],
27   "pagination": {
28     "hasMore": true,
29     "nextCursor": "eyJpZCI6IjEyMzQ1NiIsImRhdGUiOiIyMDI0LTA2LTAxVDEyOjAwOjAwWiJ9"
30   }
31 }

List record collections for the authenticated owner with cursor pagination. includeCount=true adds per-collection record counts.

Authentication

AuthorizationBearer

API key or Clerk session token

Query parameters

limitstringOptional

cursorstringOptional

includeCountstringOptional

Response

Paginated list of collections

datalist of objects

paginationobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error