---
title: "List projects — GanttFather API"
description: "Every project the token can read."
canonical: "https://ganttfather.com/docs/api/list-projects/"
locale: "en"
category: "product"
---

# List projects — GanttFather API

API reference [AI assistants (MCP)](https://ganttfather.com/docs/ai-agent/)

## Getting started

- [Introduction](https://ganttfather.com/docs/api/introduction/)
- [Authentication](https://ganttfather.com/docs/api/authentication/)
- [Pagination](https://ganttfather.com/docs/api/pagination/)
- [Rate limits & quotas](https://ganttfather.com/docs/api/rate-limits/)
- [Errors](https://ganttfather.com/docs/api/errors/)

## Projects

- [GET List projects](https://ganttfather.com/docs/api/list-projects/)
- [GET Get project](https://ganttfather.com/docs/api/get-project/)

## Tasks

- [GET List tasks](https://ganttfather.com/docs/api/list-tasks/)
- [GET Get task](https://ganttfather.com/docs/api/get-task/)
- [POST Create task](https://ganttfather.com/docs/api/create-task/)
- [PATCH Update task](https://ganttfather.com/docs/api/update-task/)
- [DELETE Delete task](https://ganttfather.com/docs/api/delete-task/)
- [POST Reorder tasks](https://ganttfather.com/docs/api/reorder-tasks/)
- [PUT Set assignees](https://ganttfather.com/docs/api/set-assignees/)

## Dependencies

- [GET List dependencies](https://ganttfather.com/docs/api/list-dependencies/)
- [PUT Set dependencies](https://ganttfather.com/docs/api/set-dependencies/)
- [POST Add dependency](https://ganttfather.com/docs/api/add-dependency/)
- [DELETE Remove dependency](https://ganttfather.com/docs/api/remove-dependency/)

## Resources

- [GET List resources](https://ganttfather.com/docs/api/list-resources/)
- [POST Create resource](https://ganttfather.com/docs/api/create-resource/)
- [PATCH Update resource](https://ganttfather.com/docs/api/update-resource/)
- [DELETE Delete resource](https://ganttfather.com/docs/api/delete-resource/)

## Members

- [GET List members](https://ganttfather.com/docs/api/list-members/)

 Projects / **List projects**

# List projects

 GET

 Updated Jul 4, 2026

 Returns every project your token can read — for a Project token, the granted set; for an Account token, every project you’re a member of or own.

 readOnlyReason is null when the project is writable.

 There are no parameters — the response is scoped by the token itself.

 curl https://api.ganttfather.com/v1/projects \
 -H "Authorization: Bearer glt_YOUR_TOKEN"

 Response 200 OK

 [
 { "id": "0198f1a2-0000-7c9e-9a1f-2d4e5f6a7b8c", "name": "Website relaunch", "active": true, "readOnlyReason": null },
 { "id": "0198f1a2-0001-7c9e-9a1f-2d4e5f6a7b8c", "name": "Q3 roadmap", "active": true, "readOnlyReason": "SubscriptionLapsed" }
]

 Rather not write REST?

## Connect an AI assistant instead.

 [Explore MCP setup →](https://ganttfather.com/docs/ai-agent/)