GET /
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