Get invoice list

GET /<provider>/get-invoices

API used to get the list of e-invoices.

Headers

Name	Required	Description
Authorization	✅	Bearer access_token
Content-Type	✅	application/json
X-Tax-Code	✅	Seller tax code.

Query Parameters

Name	Data type	Description
start	number	Start position.
count	number	Number of elements to retrieve.
serial	string	Invoice serial.
from_date	Datetime	From date.
to_date	Datetime	To date.
stax	string	Seller tax code (store, etc.).

note

The FPT provider does not support pagination.

Differences in values by provider

Field name	1Invoice	FPT	Viettel
start	Starts from 0, retrieved by the index position of the element; for example, with a page size of 10 elements, page 2 has start=10, page 3 has start=20	Starts from 0, retrieved by the index position of the element; for example, with a page size of 10 elements, page 2 has start=10, page 3 has start=20	Starts from 1, retrieved by page; for example, page 1 has start=1, page 2 has start=2
serial	Required	Do not send	Required

Response

Name	Data type	Description
data[].search_code	string	Code for the user to look up the invoice
data[].invoice_date	Datetime	Invoice issue date
data[].seq	number	Invoice number
data[].tax_authority_code	string	Tax authority code
data[].buyer	string	Organization name
data[].bname	string	Buyer name
data[].total_v	number	Total amount including tax
data[].vat_v	number	Tax amount
data[].serial	string	Invoice serial
data[].sid	string	Invoice id
data[].vpid	string	Id used to view the invoice (if any)
data[].status	number | string	Invoice status
data[].status_received	number | string	Tax authority response status
success	boolean	API status
total	number	Total number of elements matching the condition; not available for the FPT provider
message	string	Error message if any

Tax authority code and lookup code by provider

Field	1Invoice	FPT	Viettel
Tax authority code (tax_authority_code)	Yes	Yes	Requires an additional API call to get the secret code
Lookup code (search_code)	Yes	Yes	Requires an additional API call to get the secret code

1Invoice

curl --location 'https://stag-invoice-hub.1invoice.vn/1Invoice/get-invoices?start=0&count=10&serial=1C25MTS&from_date=2025-05-01&to_date=2025-06-06&stax=0106026495-998' \
--header 'authorization: Bearer O87316arj5+Od3Fqyy5hzdBfIuPk73eKqpAzBSvv8sY=' \
--header 'x-tax-code: 0106026495-998'

one-invoice

curl --location 'https://stag-invoice-hub.1invoice.vn/one-invoice/get-invoices?start=0&count=10&serial=2C26MAT&from_date=2026-04-15&to_date=2026-04-15&stax=0106026495-998&type_invoice=icr' \
--header 'accept: application/json, text/plain, */*' \
--header 'authorization: Bearer O87316arj5+Od3Fqyy5hzdBfIuPk73eKqpAzBSvv8sY=' \
--header 'x-tax-code: 0106026495-998' \
--data ''

fpt

curl --location 'https://stag-invoice-hub.1invoice.vn/fpt/get-invoices?start=0&count=10&serial=C25TAT&from_date=2025-09-24&to_date=2025-09-24&stax=0104128565-999' \
--header 'authorization: Bearer <token>' \
--header 'x-tax-code: 0104128565-999' \
--header 'Cookie: d4150655895b8526de84b2ab49c2b9e4=25b23b9c55e22b9e0de3559674a733dd'

viettel

curl --location 'https://stag-invoice-hub.1invoice.vn/viettel/get-invoices?count=10&to_date=2025-09-24&start=1&serial=K25MVV&from_date=2025-09-17&stax=0100109106-509' \
--header 'authorization: Bearer <token>' \
--header 'x-tax-code: 0100109106-509' \
--header 'Cookie: d4150655895b8526de84b2ab49c2b9e4=25b23b9c55e22b9e0de3559674a733dd'

Response

{
  "success": true,
  "total": 10,
  "data": [
    {
      "seq": 10,
      "invoice_date": "2025-05-19T00:00:00",
      "buyer": "trang",
      "bname": "trang",
      "total_v": 1100000,
      "vat_v": 100000,
      "status_received": 1,
      "serial": "1C25MTS",
      "search_code": "77C19987",
      "status": 0,
      "tax_authority_code": "M1-25-RV1DV-00000003194",
      "sid": "3a19f963-dd71-5689-56ef-9ea75cd51e55"
    },
    {
      "seq": 9,
      "invoice_date": "2025-05-19T00:00:00",
      "buyer": "trang",
      "bname": "trang",
      "total_v": 1100000,
      "vat_v": 100000,
      "status_received": 4,
      "serial": "1C25MTS",
      "search_code": "5FC2F7EE",
      "status": 0,
      "tax_authority_code": "M1-25-RV1DV-00000003173",
      "sid": "3a19f804-37d1-7e98-6b80-47ff0b4ccc6b"
    }
  ],
  "message": null
}