# General Translation Platform: Список проектов
URL: https://generaltranslation.com/ru/docs/platform/openapi/reference/project/list-projects.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Возвращает список доступных вам проектов, отсортированных по ID. Требуется разрешение project:files:read. Заголовок gt-project-id не нужен. Чтобы получить первую страницу, не указывайте cursor. Если nextCursor в ответе содержит строку, передайте её в параметре cursor, чтобы получить следующую страницу; если он равен null, результатов больше нет. Справочник API для List Projects.

{/* Этот файл автоматически создан с помощью Fumadocs. Не редактируйте его напрямую. Чтобы внести изменения, повторно выполните команду генерации. */}

## Endpoint

`GET https://api.gtx.dev/v2/projects`

**Operation ID:** `listProjects`

**Tags:** `Project`

**Summary:** List Projects

List projects you can access, ordered by ID. Requires `project:files:read`. No `gt-project-id` header is needed. Omit `cursor` for the first page. When the response's `nextCursor` is a string, pass it as `cursor` to fetch the next page; when it is `null`, there are no more results.

Authentication: required. Send an API key in the `Authorization: Bearer <key>` header when authenticating.

### Parameters

- `cursor` (query, string, optional): The nextCursor from the previous page. Omit for the first page.
- `limit` (query, integer, optional): Maximum number of items to return, 1–100. Defaults to 50.
- `gt-api-version` (header, "2025-01-01.v0" | "2025-11-03.v1" | "2026-02-18.v1" | "2026-03-06.v1", optional): API contract version. Defaults to the oldest supported version.

### Responses

**200**: Page of Projects
Response body (`application/json`, object):
- `items` (object[], required)
  - `id` (string, required)
  - `name` (string, required)
  - `orgId` (string, required)
  - `orgName` (string, required)
- `nextCursor` (string | null, required): Opaque cursor for the next page; `null` when there are no more items. Pages are read independently, so items changed between requests may be missed or repeated.

**400**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**401**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**403**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**429**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**500**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

Complete OpenAPI 3.1 specification: https://generaltranslation.com/openapi.yaml

OpenAPI schema: [openapi.json](https://generaltranslation.com/openapi.json)

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.