---
title: "Get an account"
method: GET
path: "/accounts/{id}"
tags: ["Accounts"]
---

# Get an account

`GET /accounts/{id}`

## Request

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

Get a single account (client organization) by ID.

## Path parameters

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

## Response `200`

OK

- Account
  - `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.

## 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)