---
title: "Get lists"
method: GET
path: "/projects/{project_id}/lists"
tags: ["project"]
---

# Get lists

`GET /projects/{project_id}/lists`

## Request

- Base URL: `https://api.ora.pm`
- URL: `https://api.ora.pm/projects/{project_id}/lists`
- Auth: OAuth 2
  - Authorization code: `https://app.ora.pm/authorize`
  - Token URL: `https://api.ora.pm/oauth/token` scopes: `read`, `write`

## Query parameters

- `offset` string
- `limit` string

## Response `200`

Success

- List
  - `view_id` integer: Id of the view where the list is located.
  - `updated_at` string, required: Date and time when the list was last updated.
  - `title` string, required: Title of the list.
  - `color` string: Color of the list.
  - `list_type` integer: Type of the list. 1 - Open, 2 - Closed, 3 - Review and 4 - Frosen.
  - `archived` boolean: True if the project is archived, if false it is not.
  - `actions` integer: Counter of the list actions.
  - `public` string: If true the list is public, if false - private.
  - `position` integer: Position of the list.

## Other responses

- `400`: Bad request
- `401`: Unauthorized

---

[API](https://skmtc.dev/ora/apis/ora-api.md) - [All operations](https://skmtc.dev/ora/apis/ora-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ora/apis/ora-api/revisions/983b9e0b0dda?raw)