List Accounts

GET /accounts

Get Accounts

cURL

curl --request GET \
  --url https://api.example.com/accounts \
  --header 'Authorization: Bearer <token>'

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

New to accounts? See the Accounts guide for how accounts relate to contacts and deals. This page is the field-level technical reference.

An account is a company. Deals and contacts both carry an account_id and roll up to it; deleting an account isn’t exposed here — contacts and deals just have their account_id set to null at the database level if an account is ever removed some other way.

Returns a page of the caller’s organization’s accounts, ordered alphabetically by name. This is a bare JSON array with no total-count signal — keep incrementing offset until a response comes back shorter than limit. limit defaults to 200 and is capped at 500 server-side regardless of what you pass. search does a case-insensitive substring match against name or domain. Characters that are meaningful in the underlying filter syntax are neutralized first, but not identically: parentheses are removed, while each comma is replaced with a space. Watch out for that substitution — search=Acme, Inc becomes the pattern *Acme Inc* with a doubled space, which matches nothing. Drop the comma yourself (search=Acme Inc) when the name you’re searching for contains one.

Only a fixed projection of columns is returned, not the full account row (see Response below).

Auth

Requires a CRM read scope and an active organization on the token. Any of contacts:read, deals:read, companies:read, or activities:read qualifies, as does any *:manage scope — manage implies read.

Response

Array of account objects, each with only these fields:

Field	Type	Description
id	string (uuid)	Primary key.
name	string	Account name.
industry	string | null	One of the AccountIndustry values, or null.
health_score	integer | null	Denormalized copy of the latest health score (0–100), or null if never computed. See Refresh Account Health.
domain	string | null	Primary domain.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit · integer · default: 200

Maximum number of accounts to return; capped at 500 server-side regardless of what's passed.

offset · integer · default: 0

Number of accounts to skip, for pagination.

search · string | null

Case-insensitive substring match against name or domain. Filter-syntax characters are neutralized first: parentheses are removed, and each comma is replaced with a space — so 'Acme, Inc' searches for 'Acme Inc' (doubled space) and matches nothing. Omit the comma.

Response

200

application/json

Successful Response