Skip to main content
GET
/
projects
curl "https://faces.app/api/v1/projects?limit=5&published=true" \
  -H "Authorization: Bearer $FACES_API_KEY"

{
  "projects": [
    {
      "slug": "xK9mP2qR",
      "name": "AI Healthcare Pitch",
      "publishedAt": "2025-01-15T10:30:00.000Z",
      "updatedAt": "2025-01-15T12:00:00.000Z",
      "editorUrl": "https://faces.app/s/xK9mP2qR"
    }
  ],
  "nextCursor": "cm1xyz789..."
}
​
published
string
Filter by published status. true for published only, false for unpublished only.
​
limit
integer
default:"20"
Maximum number of results per page. Min: 1, Max: 100.
​
cursor
string
Pagination cursor from a previous response’s nextCursor field.
curl "https://faces.app/api/v1/projects?limit=5&published=true" \
  -H "Authorization: Bearer $FACES_API_KEY"

{
  "projects": [
    {
      "slug": "xK9mP2qR",
      "name": "AI Healthcare Pitch",
      "publishedAt": "2025-01-15T10:30:00.000Z",
      "updatedAt": "2025-01-15T12:00:00.000Z",
      "editorUrl": "https://faces.app/s/xK9mP2qR"
    }
  ],
  "nextCursor": "cm1xyz789..."
}
​
projects
array
Array of project objects.
​
nextCursor
string
Pass this as the cursor query parameter to fetch the next page. Absent when there are no more results.