---
title: "GET /api/integration/v1/invoices — list invoices for the authenticated org (newest first). Filterable by customerId, status (name or numeric: Draft/Issued/Sent/Paid/Void), and an inclusive issue-date range (from/to, ISO-8601). Returns lightweight rows; call the by-id endpoint for full line items + snapshots."
method: GET
path: "/api/integration/v1/invoices"
tags: ["Invoices"]
---

# GET /api/integration/v1/invoices — list invoices for the authenticated org (newest first). Filterable by customerId, status (name or numeric: Draft/Issued/Sent/Paid/Void), and an inclusive issue-date range (from/to, ISO-8601). Returns lightweight rows; call the by-id endpoint for full line items + snapshots.

`GET /api/integration/v1/invoices`

## Request

- Base URL: `https://api.timix.ai`
- URL: `https://api.timix.ai/api/integration/v1/invoices`
- Auth: API key in header `X-Api-Key`

## Query parameters

- `customerId` string, nullable
- `status` string, nullable
- `from` string, date-time, nullable
- `to` string, date-time, nullable
- `pageSize` integer
- `pageNumber` integer

## Response `200`

- CRUDResponseOfListOfInvoiceSummaryView
  - `data` InvoiceSummaryView[]
    - `id` string
    - `invoiceNumber` string
    - `status` 'Draft' | 'Issued' | 'Sent' | 'Paid' | 'Void'
    - `customerId` string
    - `customerName` string
    - `invoiceDate` string, date-time, nullable
    - `dueDate` string, date-time, nullable
    - `periodStart` string, date-time
    - `periodEnd` string, date-time
    - `currency` string
    - `totalAmount` number
    - `isCreditNote` boolean
    - `frameOrderId` string, nullable
    - `frameOrderReference` string, nullable
    - `createdAt` string, date-time
  - `validationErrors` string[], nullable
  - `errorMessage` string, nullable
  - `errorCode` string, nullable
  - `errorDetails` object, nullable
  - `httpStatusCode` 'Continue' | 'SwitchingProtocols' | 'Processing' | 'EarlyHints' | 'OK' | 'Created' | 'Accepted' | 'NonAuthoritativeInformation' | 'NoContent' | 'ResetContent' | 'PartialContent' | 'MultiStatus' | 'AlreadyReported' | 'IMUsed' | 'MultipleChoices' | 'MultipleChoices' | 'MovedPermanently' | 'MovedPermanently' | 'Found' | 'Found' | 'SeeOther' | 'SeeOther' | 'NotModified' | 'UseProxy' | 'Unused' | 'RedirectKeepVerb' | 'RedirectKeepVerb' | 'PermanentRedirect' | 'BadRequest' | 'Unauthorized' | 'PaymentRequired' | 'Forbidden' | 'NotFound' | 'MethodNotAllowed' | 'NotAcceptable' | 'ProxyAuthenticationRequired' | 'RequestTimeout' | 'Conflict' | 'Gone' | 'LengthRequired' | 'PreconditionFailed' | 'RequestEntityTooLarge' | 'RequestUriTooLong' | 'UnsupportedMediaType' | 'RequestedRangeNotSatisfiable' | 'ExpectationFailed' | 'MisdirectedRequest' | 'UnprocessableEntity' | 'UnprocessableEntity' | 'Locked' | 'FailedDependency' | 'UpgradeRequired' | 'PreconditionRequired' | 'TooManyRequests' | 'RequestHeaderFieldsTooLarge' | 'UnavailableForLegalReasons' | 'InternalServerError' | 'NotImplemented' | 'BadGateway' | 'ServiceUnavailable' | 'GatewayTimeout' | 'HttpVersionNotSupported' | 'VariantAlsoNegotiates' | 'InsufficientStorage' | 'LoopDetected' | 'NotExtended' | 'NetworkAuthenticationRequired'
  - `success` boolean

---

[API](https://skmtc.dev/timix/apis/timix-ai-integration-api.md) · [All operations](https://skmtc.dev/timix/apis/timix-ai-integration-api/llms.txt) · [OpenAPI document](https://skmtc.dev/timix/apis/timix-ai-integration-api/revisions/ff7f1b6d7479?raw)