Skip to main content
GET
/
api
/
projects
List Projects
curl --request GET \
  --url https://api.example.com/api/projects
{
  "id": 123,
  "name": "<string>",
  "color": "<string>",
  "userId": 123
}
Returns a list of all projects belonging to the authenticated user.

​
Authentication

Requires Bearer token authentication.

​
Response

​
id
integer
required
The unique identifier for the project
​
name
string
required
The name of the project (max 100 characters)
​
color
string
required
The color code for the project in hex format (e.g., #8b949e)
​
userId
integer
required
The ID of the user who owns the project

​
Example Request

curl -X GET https://api.example.com/api/projects \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

​
Example Response

[
  {
    "id": 1,
    "name": "Website Redesign",
    "color": "#3b82f6",
    "userId": 123
  },
  {
    "id": 2,
    "name": "Mobile App",
    "color": "#10b981",
    "userId": 123
  }
]

​
Error Responses

​
401 Unauthorized
Authentication token is missing or invalid
{
  "error": "Unauthorized",
  "message": "Invalid or missing authentication token"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us