List invoices · Fieldmotion API

When to use this endpoint

Use this unpaginated route for invoice pickers and job-to-invoice linking. ID is always returned.

The request must use a logged-in CRM session or valid signed API credentials and is scoped to that tenant.

Users whose legacy crm_access mask contains bit 64 receive {"error":"no permission to access api"}. No record-owner check is made.

Parameter	Type	Required	Description
`fields`	JSON array string	No	Optional fields: `num`, `cdate`, `customer_id`, `customer_type`, `last_edited`, and `status`. Unknown names are ignored.
`open`	Mixed	No	Presence adds `status<2`, regardless of value.
`status / status_max`	Integer-compatible	No	Exact or maximum status. Conditions combine if both are supplied.
`customer_id / customer_type`	Integers	Together	Direct target. Customer targets also include parent and siblings; asset targets also include owner, owner parent, and children of that parent.
`days_from / days_to`	Integer day offsets	No	Bounds relative to today; the upper bound adds one extra day.
`last_edited_from / last_edited_to`	Unix seconds	No	Inclusive edit checkpoint bounds.
`ids`	JSON array	No	Limits to integer-coerced IDs. An empty decoded list is rejected.

$rows = FM_api('Invoices_list', [
	'open' => 1,
	'fields' => json_encode(['num', 'cdate', 'status']),
]);

[
  {"id": "981", "num": "INV-981", "cdate": "2026-10-02", "status": "1"}
]

Response	Condition
`{"error":"not logged in"}`	No authenticated tenant context is available. Invalid signed credentials can be rejected by the dispatcher before the handler runs.
`{"error":"no permission to access api"}`	The legacy access bit is set.
`{"error":"invalid parameter: ids"}`	IDs decodes to an empty array.

Legacy application errors may be returned with HTTP 200. Check the decoded response for error, not only the HTTP status.

There is no explicit ordering or page limit.
All filters combine with AND except target-family expansion inside the customer condition.
Fields parsing is activated only when the trimmed JSON string is longer than four characters. Malformed iterable input is legacy unsafe and should not be sent.

Invoice widgets, Job invoice linking, and the Job invoice page call this route.

Invoice table widgets and Job linking use the same endpoint.