Invoice List API

API Endpoint

GET

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

API Request

pageinteger

Current page (default 1)

Default: 1

per_pageinteger

Records per page (default 10)

Default: 10

sourceenum

Filter invoices by creation source. Returns all invoices if omitted.

manual: Only invoices created via the web UI
api: Only invoices created via the API

document_typestring

Filter by invoice kind. Accepts several kinds as a comma-separated list (e.g. 6,7).

Returns all invoices if omitted.

1: Draft invoice
2: New invoice
3: Cancelled invoice
4: Replacement invoice
5: Replaced invoice
6: Increase adjustment invoice
7: Decrease adjustment invoice
8: Information adjustment invoice
9: Combined adjustment invoice
10: Adjusted invoice

seller_store_xidstring

Filter invoices by seller business location - pass the location's xid. Returns all invoices if omitted.

Pagination

Use page to specify the page number (default is 1).
Use per_page to limit records per page (default is 10, maximum 100).
Response returns has_more: true if there is more data on the next page.

API Response

Success 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": "2026-01-26",
        "pdf_url": "https://beta-portalv2.mifi.vn/DownloadPDFCA.aspx?...",
        "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"
        },
        "seller_store": {
          "xid": "8f14e45f-ceea-4b6d-9c1a-2b3c4d5e6f70",
          "code": "CN01",
          "name": "Chi nhánh 1"
        },
        "total_before_tax": 200000,
        "tax_amount": 20000,
        "total_amount": 220000,
        "notes": "Ghi chú hóa đơn",
        "source": "api"
      }
    ]
  }
}

dataobject

Note about invoice_number

invoice_number defaults to "0" when the invoice is in draft status ("status": "draft"). After successful issuance, invoice_number will be updated to the actual invoice number assigned by the provider.

Error Handling

401Unauthorized

Missing or invalid Bearer token. Please verify your token in the Authorization header.

Code Examples

curl --request GET \
  --url 'https://einvoice-api.sepay.vn/v1/invoices?page=1&per_page=10&source=manual&document_type=6%2C7&seller_store_xid=8f14e45f-ceea-4b6d-9c1a-2b3c4d5e6f70' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Next Steps

After getting the invoice list, you can:

Invoice Details - Use the reference_code to view detailed information of a specific invoice
Download Invoice - Download the PDF or XML file of an issued invoice

For draft invoices

If an invoice has status: "draft", you can Issue eInvoice to officially issue it.