Invoice List

API to query invoice list with pagination.

GET

https://einvoice-api-sandbox.sepay.vn/v1/invoices

  -H "Authorization: Bearer <ACCESS_TOKEN>"

Query parameters:

Name	Type	Required	Description
`page`	integer	Not required	Current page (default 1).
`per_page`	integer	Not required	Items per page (default 10).

Note

Bearer token required.
Response includes paging and invoice items.

401

Unauthorized

Missing or invalid Bearer token.

—

bash

RESPONSE 200

{
  "data": {
    "paging": {
      "per_page": 1,
      "total": 20,
      "has_more": true,
      "current_page": 1,
      "page_count": 20
    },
    "items": [
      {
        "reference_code": "9735f09d-d970-11f0-aef4-52c7e9b4f41b",
        "invoice_number": "0",
        "issued_date": "2025-12-15",
        "pdf_url": "https://beta-portalv2.mifi.vn/DownloadPDFCA.aspx?kk=1434747710&keyinv=mfUkpPMDFJVmxlb0E9&coid=MWNuWGNKQkk0MjA9&p=5&c=0&publishDomain=https://demo.matbao.in",
        "xml_url": null,
        "status": "draft",
        "buyer": {
          "name": "Công ty ABC",
          "tax_code": "0101234567",
          "address": "123 Đường A, Quận B, Hà Nội",
          "email": "buyer@example.com",
          "phone": "0900000000"
        },
        "total_before_tax": 200000,
        "tax_amount": 20000,
        "total_amount": 220000,
        "notes": "Ghi chú hóa đơn"
      }
    ]
  }
}

Note

invoice_number defaults to 0 when the invoice is a draft ("status": "draft").

data.pagingobject

Paging info.

data.itemsarray

Invoice list.