---
title: "Get a project"
method: GET
path: "/projects/{id}"
tags: ["Projects"]
---

# Get a project

`GET /projects/{id}`

## Request

- Base URL: `https://api.parley.so/v1`
- URL: `https://api.parley.so/v1/projects/{id}`
- Auth: HTTP bearer

Get a single project (matter or case) by ID.

## Path parameters

- `id` string, required: The project ID.

## Response `200`

OK

- Project
  - `id` string, required: The project ID.
  - `name` string, required: Project name.
  - `access` union, required: Who can see the project: everyone in the organization, or only its members.
    - EveryoneProjectAccess
      - `type` 'everyone', required
    - MembersProjectAccess
      - `type` 'members', required
      - `members` UserRef[], required: The people who can see the project.
        - `id` string, required: The user's ID.
        - `name` string, nullable, required: The user's full name, or null when it is unknown, as for someone who has left the organization.
        - `email` string, nullable, required: The user's email address, or null when it is unknown.
  - `accounts` AccountRef[], required: The accounts linked to the project. Direct links only: the accountId filter on the project list also matches projects linked through one of the account's contacts.
    - `type` 'account', required
    - `id` string, required: Its ID.
    - `name` string, required: The account name.
  - `contacts` ContactRef[], required: The contacts linked to the project.
    - `type` 'contact', required
    - `id` string, required: Its ID.
    - `name` string, required: The contact's first and last name, or an email address when it has no name.
  - `createdAt` string, date-time, required: When the project was created.
  - `updatedAt` string, date-time, required: When the project was last updated, including changes to its linked accounts and contacts. Field value changes do not change it.
  - `fields` object, required: Custom field values, keyed by field name, with a key for every field defined for projects (null when unset). The value's shape follows the field's type.

## Other responses

- `400`: The request was invalid. VALIDATION_FAILED.
- `401`: Missing or invalid credentials. UNAUTHORIZED.
- `403`: You don't have permission. FORBIDDEN.
- `404`: Not found. NOT_FOUND.
- `429`: Too many requests, or a usage limit was reached. TOO_MANY_REQUESTS.

---

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