Skip to main content
GET
/
api
/
v1
/
projects
List Projects
curl --request GET \
  --url https://api.example.com/api/v1/projects \
  --header 'Authorization: <authorization>'
{
  "projects": [
    {}
  ],
  "pagination": {}
}

​
Overview

Get a list of all video projects for the authenticated user. Supports pagination.

​
Request

​
Headers

​
Authorization
string
required
Bearer token with your API key

​
Query Parameters

​
limit
number
default:"20"
Number of projects to return (max: 100)
​
offset
number
default:"0"
Number of projects to skip for pagination

​
Response

​
projects
array
Array of project objects
​
pagination
object
Pagination metadata with limit, offset, and total

​
Examples

curl https://api.babou.ai/api/v1/projects \
  -H "Authorization: Bearer $BABOU_API_KEY"

# With pagination
curl "https://api.babou.ai/api/v1/projects?limit=50&offset=100" \
  -H "Authorization: Bearer $BABOU_API_KEY"

​
Response Example

{
  "projects": [
    {
      "id": "prj_abc123xyz",
      "name": "Product Launch Video",
      "description": "Marketing video for Q4 2025",
      "settings": null,
      "active_export_id": "exp_xyz789abc",
      "created_at": "2025-12-02T10:00:00Z"
    },
    {
      "id": "prj_def456uvw",
      "name": "Tutorial Series",
      "description": "Educational content",
      "settings": null,
      "active_export_id": null,
      "created_at": "2025-12-01T15:30:00Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 42
  }
}

​
Next Steps

Create Project

Create a new project

Get Project

Get project details