API tra cứu lịch sử gửi email hóa đơn

Tra cứu lịch sử gửi email hóa đơn điện tử qua SePay eInvoice API với phân trang. Cho biết hóa đơn đã gửi tới email nào, trạng thái và thời điểm gửi.

||

API Endpoint

GET
https://einvoice-api.sepay.vn/v1/email-logs

API Request

pageinteger

Trang hiện tại (mặc định 1)

Mặc định: 1
per_pageinteger

Số bản ghi mỗi trang (mặc định 20, tối đa 100)

Mặc định: 20
invoice_numberstring

Lọc theo số hóa đơn (khớp một phần)

statusenum

Lọc theo trạng thái gửi email. Nếu không truyền sẽ trả về tất cả.

  • pending: Chờ gửi
  • sending: Đang gửi
  • sent: Đã gửi thành công
  • failed: Gửi thất bại (còn có thể thử lại)
  • retrying: Đang thử gửi lại
  • permanent_failed: Thất bại vĩnh viễn (đã hết lượt thử lại)
to_emailstring

Lọc theo địa chỉ email nhận (khớp một phần)

reference_codestring

Lọc theo mã tham chiếu hóa đơn (khớp một phần)

Phân trang
  • Sử dụng page để chỉ định trang cần lấy (mặc định là 1).
  • Sử dụng per_page để giới hạn số bản ghi mỗi trang (mặc định là 20, tối đa 100).
  • Response trả về has_more: true nếu còn dữ liệu ở trang tiếp theo.

API Response

Response thành công (200)
{
  "data": {
    "paging": {
      "per_page": 20,
      "total": 3,
      "has_more": false,
      "current_page": 1,
      "page_count": 1
    },
    "items": [
      {
        "invoice_series": "C26TSE",
        "invoice_number": "3872",
        "full_invoice_number": "C26TSE3872",
        "reference_code": "3a012136-6577-11f1-9f9b-52c7e9b4f41b",
        "to_email": "buyer@example.com",
        "status": "sent",
        "sent_at": "2026-06-11 14:26:40",
        "created_at": "2026-06-11 14:26:35"
      }
    ]
  }
}
dataobject
Về trường status

status cho biết trạng thái gửi email: pending (chờ gửi), sending (đang gửi), sent (đã gửi thành công), failed (thất bại, còn có thể thử lại), retrying (đang thử lại), permanent_failed (thất bại vĩnh viễn, đã hết lượt thử lại). Khi email chưa gửi thành công, sent_at là null.

Xử lý lỗi

401Unauthorized

Thiếu hoặc sai Bearer token. Vui lòng kiểm tra lại token trong header Authorization.

Code mẫu

>
>
>
curl --request GET \
  --url 'https://einvoice-api.sepay.vn/v1/email-logs?page=1&per_page=20&invoice_number=3872&status=sent&to_email=buyer%40example.com&reference_code=3a012136-6577-11f1-9f9b-52c7e9b4f41b' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Bước tiếp theo

Từ mã tham chiếu (reference_code) trong kết quả, bạn có thể:

  1. Chi tiết hóa đơn - Xem thông tin chi tiết của hóa đơn tương ứng
  2. Tải hóa đơn - Tải file PDF hoặc XML của hóa đơn đã phát hành
Trước
—
Tiếp theo
—