---
title: "List accounts"
method: GET
path: "/accounts"
tags: ["Accounts"]
---

# List accounts

`GET /accounts`

## Request

- Base URL: `https://api.parley.so/v1`
- URL: `https://api.parley.so/v1/accounts`
- Auth: HTTP bearer

List accounts (the client organizations the firm works with), newest first by default. Filter by name, linked project, and when accounts were created or updated. An account's updatedAt covers the account itself; contacts joining or leaving do not change it.

## Query parameters

- `search` string: Case-insensitive. Every word must match the account name or a text custom field.
- `projectId` string: Only accounts linked to this project.
- `createdSince` string: Only records created at or after this time. An ISO 8601 date (YYYY-MM-DD, read as UTC midnight) or date-time.
- `createdBefore` string: Only records created before this time. An ISO 8601 date (YYYY-MM-DD, read as UTC midnight) or date-time.
- `updatedSince` string: Only records last updated at or after this time. An ISO 8601 date (YYYY-MM-DD, read as UTC midnight) or date-time.
- `updatedBefore` string: Only records last updated before this time. An ISO 8601 date (YYYY-MM-DD, read as UTC midnight) or date-time.
- `sort` 'name' | '-name' | 'createdAt' | '-createdAt' | 'updatedAt' | '-updatedAt': Sort order: a field name, prefixed with - for descending. Defaults to -createdAt.
- `cursor` string: Opaque cursor from nextCursor. Pass the same filters and sort. Omit for the first page.
- `limit` integer: Maximum number of items to return.

## Response `200`

OK

- object
  - `data` Account[], required
    - `id` string, required: The account ID.
    - `name` string, required: Account name.
    - `contactCount` integer, required: How many contacts belong to the account. List them by filtering contacts by accountId.
    - `projectCount` integer, required: How many projects you can see are linked directly to the account. Filtering projects by accountId also returns the projects linked through the account's contacts. Linking or unlinking a project doesn't change the account's updatedAt.
    - `createdAt` string, date-time, required: When the account was created.
    - `updatedAt` string, date-time, required: When the account itself was last updated. Contacts joining or leaving the account, links to projects, and 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 accounts (null when unset). The value's shape follows the field's type.
  - `nextCursor` string, nullable, required: Cursor for the next page, or null on the last page.

## Other responses

- `400`: The request was invalid. VALIDATION_FAILED, INVALID_CURSOR.
- `401`: Missing or invalid credentials. UNAUTHORIZED.
- `403`: You don't have permission. FORBIDDEN.
- `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)