List Accounts

Returns a paginated list of accounts.

Request body

pageinteger

Page number (1-indexed)

page_sizeinteger

Number of results per page

sortstring

Field to sort by. Prefix with '-' for descending order.

include_custom_fieldsboolean

Whether to include custom fields (custom_field_<uuid> keys) on each returned account. Defaults to true. Set false to omit them for leaner responses; GET /v1/accounts/{account_id} always returns them.

Response

Successful Response

Example response

{
  "data": [
    {
      "id": "acc_abc123",
      "name": "Acme Corp",
      "status": "active",
      "owner": {
        "id": "usr_abc123",
        "first_name": "Jane",
        "last_name": "Smith"
      },
      "notes": "Key enterprise prospect",
      "company": {
        "domain": "acme.com",
        "linkedin_url": "https://linkedin.com/company/acme",
        "description": "Enterprise software company specializing in AI-driven sales tools",
        "employee_count": 250,
        "founded_year": 2019,
        "industries": [
          "Software",
          "Artificial Intelligence"
        ],
        "total_funding_usd": 50000000,
        "last_funding_date": "2024-03-15"
      },
      "scoring": {
        "tier": "A",
        "heat_score": "Hot"
      },
      "tags": [
        "Enterprise",
        "High Priority"
      ],
      "created_at": "2025-06-15T10:30:00Z",
      "updated_at": "2025-06-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 25,
    "total_count": 142,
    "total_pages": 6
  }
}