Invoice list

Retrieve the list of synced invoices for an account. Supports filtering and pagination.

GET /invoices

Query params

Param	Type	Meaning
accountId	UUID	Required — the account to look up
direction	string	purchase (default filter)
sellerTaxCode	string	Filter by seller tax code
dateFrom / dateTo	date	Filter by issue date
page / limit	int	Pagination (default 1 / 20)
sort	string	issueDate:desc | syncedAt:desc

Example response

{
  "data": [
    {
      "id": "0de33a81-fd05-4a1b-9c94-116f62c56057",
      "sellerTaxCode": "0101234567",
      "sellerName": "CÔNG TY TNHH THƯƠNG MẠI ABC",
      "buyerTaxCode": "0319074775",
      "invoiceSymbol": "K25TAA",
      "invoiceNumber": "88",
      "issueDate": "2025-03-15",
      "totalBeforeTax": 5000000,
      "totalTax": 400000,
      "totalAmount": 5400000,
      "currency": "VND"
    }
  ],
  "total": 12, "page": 1, "limit": 20, "totalPage": 1
}

note

Only identifier fields (seller/buyer tax code, invoice number/serial, issue date) are stored in a filterable form. Names and amounts are decrypted when returned. Sorting by amount is not supported (monetary data is encrypted).