GET /api/v1/projects/list

List Projects

List the projects owned by the authenticated principal. This route is useful when your application needs to browse or reconcile the project inventory for an account.

GET
https://api.vidbyte.pro/api/v1/projects/list

Example request

bash
curl "https://api.vidbyte.pro/api/v1/projects/list?limit=20&page=1" \ -H "x-api-key: vb_live_your_api_key"

Example response

JSON
{ "success": true, "message": "Projects retrieved successfully.", "data": [ { "encrypted_id": "7d444840-9dc0-41a2-b7f3-0c3b6a5e4f21", "title": "Design a portfolio-ready backend observability project for an intermediate engineer. Keep it deep but practical.", "description": null, "project_data": { "generation_status": "project_completed" }, "status": "active", "tags": [], "version": null, "actions_applied": [], "created_at": "2026-04-10T18:00:00", "updated_at": "2026-04-10T18:00:00" } ], "object": "project", "pagination": { "limit": 20, "page": 1, "has_more": false } }

Parameter information

These are the public parameters for /api/v1/projects/list. Path, query, and request-body parameters are shown together so the page stays focused on the live request contract you actually send.

limitintegerOptional

Query parameter: how many items to return per page, from 1 to 100, for example ?limit=20.

Default

100