---
title: "Get Accounts"
method: GET
path: "/crm/accounts"
tags: ["CRM Service Calls"]
---

# Get Accounts

`GET /crm/accounts`

Retrieve accounts (companies/organizations) with optional filtering, sorting, and pagination.

Accounts represent business entities such as customers, vendors, or partners.
Without filters, returns the most recent accounts sorted newest first.

**Query Parameters:**

- **match_filter_dict** *(optional)*: JSON-encoded MongoDB query. Must use exact database
  field names — do not use pseudo-fields like `created_at`.
  Filterable fields include: `status`, `source`, `relationship_type`, `name`,
  `company_name`, `industry`, `tags`, `email_list`, `phone_list`.
  Examples:
    - `{"status": "customer"}` — active customers
    - `{"relationship_type": "vendor"}` — vendor accounts
    - `{"industry": "technology"}` — tech-sector accounts
- **eval_object_id** *(default: false)*: Set to true when using `ObjectId('...')` syntax in filters.
- **sort_dict** *(default: {"_id": -1})*: JSON-encoded sort criteria.
- **page_size** *(default: 50)*: Number of records per page.

**Response:** Array of account objects with id, name, status, source, relationship_type,
company_name, industry, num_employees, contact info, dates, tags, and social profiles.

## Query parameters

- `match_filter_dict` string
- `eval_object_id` boolean
- `sort_dict` string
- `page_size` integer

## Response `200`

Successful Response

- AccountResponse[]
  - `id` string, required
  - `name` string, required
  - `phone_list` unknown[], nullable
    - unknown
  - `email_list` unknown[], nullable
    - unknown
  - `status` string, nullable
  - `source` string, nullable
  - `relationship_type` string, nullable
  - `website` string, nullable
  - `company_name` string, nullable
  - `description` string, nullable
  - `industry` string, nullable
  - `num_employees` integer, nullable
  - `tags` string[], nullable
  - `social_dict_list` object[], nullable
  - `created_date` string, nullable
  - `updated_date` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ambivo/apis/ambivo-api.md) · [All operations](https://skmtc.net/ambivo/apis/ambivo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ambivo/ambivo-api/versions/165a6d16a9a0/schema)