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

# Get Accounts

`GET /crm/accounts`

## Request

- Base URL: `https://fapi.ambivo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://fapi.ambivo.com/crm/accounts`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/ambivo/apis/ambivo-api/docs/crm/accounts/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-08-06** `165a6d16a9a0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ambivo/apis/ambivo-api/changes/crm/accounts/get.md)

---

[API](https://skmtc.dev/ambivo/apis/ambivo-api.md) - [All operations](https://skmtc.dev/ambivo/apis/ambivo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ambivo/apis/ambivo-api/revisions/165a6d16a9a0?raw)