---
title: "List projects"
method: GET
path: "/projects"
tags: ["Projects"]
---

# List projects

`GET /projects`

Lists all projects in your organization.

## Query parameters

- `pagination[limit]` integer
- `pagination[offset]` integer
- `order[by]` 'name' | 'created'
- `order[dir]` 'asc' | 'desc'
- `filter[environment]` 'production' | 'staging'
- `filter[name]` string
- `filter[language.code]` string

## Response `200`

OK

- ProjectModel[]
  - `id` integer — Unique identifier for the object
  - `name` string — The project name
  - `language` string — The default language of the project (ISO 639-1 code with optional region, e.g., en_GB)
  - `language_data` object — Additional language metadata for the project
  - `environment` 'production' | 'staging', nullable
  - `logo_color` string, nullable
  - `content_total_count` integer
  - `content_updated` string, date-time, nullable
  - `title` object
    - `enabled` boolean — When true, include content titles in generated audio (default is true)
    - `voice` object, nullable
      - `id` integer — The title voice id
      - `name` string — The title voice name
      - `speaking_rate` integer — The speaking rate of the voice
      - `multilingual_mode` boolean
      - `expressiveness` number, nullable
      - `use_speaker_boost` boolean, nullable
      - `similarity_boost` number, nullable
      - `style` number, nullable
  - `summary` object, nullable
    - `enabled` boolean — When true, include summary audio (default is false)
    - `voice` object, nullable
      - `id` integer — The summary voice id
      - `name` string — The summary voice name
      - `speaking_rate` integer — The speaking rate of the voice
      - `multilingual_mode` boolean
      - `expressiveness` number, nullable
      - `use_speaker_boost` boolean, nullable
      - `similarity_boost` number, nullable
      - `style` number, nullable
  - `body` object
    - `enabled` boolean — When true, include body text in generated audio (default is true)
    - `voice` object, nullable
      - `id` integer — The body voice id
      - `name` string — The body voice name
      - `speaking_rate` integer — The speaking rate of the voice
      - `multilingual_mode` boolean
      - `expressiveness` number, nullable
      - `use_speaker_boost` boolean, nullable
      - `similarity_boost` number, nullable
      - `style` number, nullable
  - `background_track` object, nullable
    - `enabled` boolean
    - `track` object, nullable
      - `id` integer
      - `name` string
      - `custom` boolean
      - `volume` integer
      - `url` string, uri
  - `auto_publish_enabled` boolean — When true, automatically distribute content once generated (default is true)
  - `auto_video_publish_enabled` boolean — When true, automatically distribute video content once generated (default is true)
  - `time_zone` string — The project time zone (IANA time zone name)
  - `avatar_url` string, uri, nullable — The project's avatar URL
  - `pause_after_title_segments_seconds` number
  - `pause_after_segments_seconds` number
  - `created` string, date-time — Time at which the object was created (ISO 8601)
  - `updated` string, date-time — Time at which the object was updated (ISO 8601)

## Other responses

- `401` — Invalid authentication token

---

[API](https://skmtc.net/beyondwords/apis/beyondwords-rest-api.md) · [All operations](https://skmtc.net/beyondwords/apis/beyondwords-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/beyondwords/beyondwords-rest-api/revisions/8c4bfe3e2ebd/schema)