Skip to content

📄 Invoices

Create, send, and manage invoices.

Operations

List invoices

Request

Retrieve invoices with comprehensive filtering and financial data

This endpoint delivers complete invoice management functionality with:

  • Advanced pagination for large invoice datasets
  • Multi-dimensional filtering (client, status, date ranges)
  • Integration with AR transactions for complete financial context
  • Tax, interest, and payment status tracking
  • Client relationship data for each invoice
  • Aggregate counting for reporting and analytics

Key Financial Features:

  • Invoice status tracking (PENDING, PAID, OVERDUE, POSTED, etc.)
  • Tax and interest calculations included
  • Due date monitoring for collections management
  • AR transaction linkage for payment reconciliation
  • Amount and allocation tracking for financial reporting

Filtering Capabilities:

  • Client-specific invoice retrieval
  • Status-based filtering for workflow management
  • Date range queries for period reporting
  • Sorting by creation date or transaction date

Business Applications:

  • Accounts receivable management and aging reports
  • Client billing history and statement generation
  • Collections management and overdue tracking
  • Financial reporting and revenue recognition
  • Payment reconciliation and allocation tracking

Real Example:

curl --location 'https://{{host}}/v1/invoices' \
--header 'Authorization: bearer {{token}} \
--header 'Content-Type: application/json' \
--data '{
  "pageSize": 25,
  "page": 0
}'
Security
BearerAuth
Bodyapplication/json
pageSizeinteger, [ 1 .. 1000 ]

Maximum number of invoice records to return

Default:25
Example:25
pageinteger, >= 0

Page number for pagination (0-based)

Default:0
Example:0
clientIdinteger

Filter invoices by specific client ID

Example:7720
statusstring

Filter by invoice status

Enum:"PENDING""POSTED""PAID""OVERDUE""CANCELLED""DRAFT"
Example:"POSTED"
startDatestring, (date-time)

Start date for invoice date range filter

Example:"1990-01-01T00:00:00"
endDatestring, (date-time)

End date for invoice date range filter

Example:"2024-12-31T23:59:59"
sortOrderstring

Sort order for invoice dates

Default:"desc"
Enum:"asc""desc"
Example:"desc"
curl -i -X POST \
  https://api.doc.aiwyn.ai/_mock/bundle/gql/v1/invoices \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "pageSize": 25,
    "page": 0
  }'

Responses

Successfully retrieved invoice records

Bodyapplication/json
invoicesArray of objects
totalobject
Response
{
  "invoices": [
    { … },
    { … },
    { … }
  ],
  "total": {
    "aggregate": { … }
  }
}