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

# Get Invoices

`GET /crm/invoices`

## 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/invoices`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/ambivo/apis/ambivo-api/docs/crm/invoices/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve invoices with optional filtering, sorting, pagination, and date range.

Returns invoices matching your criteria. Without `start_date`/`end_date`, returns all
matching invoices sorted newest first.

**Time-based filtering (start_date / end_date):**

Use `start_date` and `end_date` to filter invoices by creation date.
Both accept **ISO 8601 UTC** strings.

- Format: `YYYY-MM-DDTHH:MM:SSZ` (full) or `YYYY-MM-DD` (date only = midnight UTC)
- Both are optional — provide one or both.
- **Do NOT pass date/timestamp fields inside `match_filter_dict`** — use these parameters instead.

**Example requests:**

- All invoices (no date filter):
  `GET /invoices`
- Invoices created in the last 7 days:
  `GET /invoices?start_date=2026-03-22T00:00:00Z&end_date=2026-03-29T23:59:59Z`
- Open invoices created this month:
  `GET /invoices?start_date=2026-03-01&match_filter_dict={"stage": "open"}`

**Other Query Parameters:**

- **match_filter_dict** *(optional)*: JSON-encoded MongoDB query for non-date fields.
  Filterable fields: `stage`, `invoice_type`, `total_amount`, `invoice_date`,
  `account_id`, `contact_id`.
- **sort_dict** *(default: {"_id": -1})*: JSON-encoded sort criteria.
- **page_size** *(default: 50, max: 500)*: Number of records per page.

**Response:** Array of invoice objects with id, name, stage, invoice_num, total_amount,
invoice_date, description, timestamps, contact, and opportunity references.

## Query parameters

- `match_filter_dict` string
- `sort_dict` string
- `page_size` integer
- `start_date` string, nullable: Start of date range in ISO 8601 format (e.g. 2026-03-22T00:00:00Z or 2026-03-22). UTC.
- `end_date` string, nullable: End of date range in ISO 8601 format (e.g. 2026-03-29T23:59:59Z or 2026-03-29). UTC.

## Response `200`

Successful Response

- InvoiceResponse[]
  - `id` string, required
  - `name` string, nullable
  - `stage` string, nullable
  - `description` string, nullable
  - `invoice_num` string, nullable
  - `total_amount` string, nullable
  - `invoice_date` string, nullable
  - `created_ts` string, nullable
  - `created_ts_date` string, nullable
  - `updated_ts` string, nullable
  - `updated_ts_date` string, nullable
  - `contact` string, nullable
  - `opportunity` 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/invoices/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)