List manual taxable documents

Operation ID: manualTaxableDocuments

Group: Accounting › Tax Documents › Manual Taxable Documents

Open in the interactive reference

GET /tax-documents/manual-taxable-documents

Read-only: Reads and returns; changes nothing.

Lists manual taxable documents, also called ad hoc documents. Each document has its main fields only. For the full record, with its lines, use GET tax-documents/manual-taxable-documents/:id or POST tax-documents/manual-taxable-documents/search. To match on customer name, document number, or text, use POST tax-documents/manual-taxable-documents/search.

Parameters

Query surface

• id — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• type — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• invoiceDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• serviceDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• dueDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• currency — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• paymentStatus — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• hasAttachment — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• customerId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• entityId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• totalTaxAmount — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• totalAmount — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• totalAllocatedAmount — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• totalOpenAmount — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• lastModifiedDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• Orderable: id, type, invoiceDate, serviceDate, dueDate, currency, paymentStatus, hasAttachment, customerId, entityId, totalTaxAmount, totalAmount, totalAllocatedAmount, totalOpenAmount, lastModifiedDate
• Selectable: id, type, taxDocumentNumber, documentNumber, title, description, invoiceDate, serviceDate, dueDate, currency, paymentStatus, paymentTerms, hasAttachment, customerId, customerName, customerNumber, entityId, entityName, totalTaxAmount, totalAmount, totalAllocatedAmount, totalOpenAmount, lastModifiedDate
• page[size] — Page size
• page[cursor] — Opaque continuation cursor

Response

200 Success

Under data, an array of manualTaxableDocumentsRow:

{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "type": "<type>",
      "taxDocumentNumber": "<taxDocumentNumber>",
      "documentNumber": "<documentNumber>",
      "title": "<title>",
      "description": "<description>",
      "invoiceDate": "2026-01-15",
      "serviceDate": "2026-01-15",
      "dueDate": "2026-01-15",
      "currency": "<currency>",
      "paymentStatus": "<paymentStatus>",
      "paymentTerms": "<paymentTerms>",
      "hasAttachment": true,
      "customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "customerName": "<customerName>",
      "customerNumber": "<customerNumber>",
      "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "entityName": "<entityName>",
      "totalTaxAmount": "19.99",
      "totalAmount": "19.99",
      "totalAllocatedAmount": "19.99",
      "totalOpenAmount": "19.99",
      "lastModifiedDate": "2026-01-15T09:30:00.000Z"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "<nextCursor>"
  }
}

Statuses

• 400 — Invalid request or business failure
• 401 — The request carries no valid access token.
• 403 — Not authorized
• 404 — Not found
• 429 — Too many requests from this client address. The response has no body and no Retry-After header.
• 500 — Internal server error