> For the complete documentation index, see [llms.txt](https://docs.talkstack.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.talkstack.ai/project/getting-list-of-projects.md).

# Getting list of projects

**Step1: Prepare Your Request**

* **Endpoint:** `/project/list`
* **Method:** `GET`
* **URL:** `https://api.talkstackai.com/project/list`
* **Headers:** Include `Content-Type: application/json`.
* **Authorization:** Bearer token or x-api-key in Headers

**Step 2: Send the Request**

Use your preferred HTTP client to send the GET request.

**Step 3: Handle the request**

The response will provide a detailed list of projects created by logged in user.

**Success Response:**

* **Status Code:** `200 OK`
* **Body:**

```
{
    "message": "successfully fetched projects.",
    "projects": [
        {
            "name": "My First Project",
            "description": "Project description",
            "id": "XXXXXXXXXXXXXXXXXXX",
            "status": "ACTIVE",
            "call_status_webhook": null
        },
        {
            "name": "Demo Project",
            "description": "Project description",
            "id": "XXXXXXXXXXXXXXXXXXXXX",
            "status": "ACTIVE",
            "call_status_webhook": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
        }
    ]
}
```

**Troubleshooting**

* `401 Unauthorized`: If the user is unauthorized or the token is missing.
* `404 Not Found`: If no projects are associated with the user.
* `500 Internal Server Error`: For errors in getting project list.

Last updated 15 hours ago