Get declaration status

GET /core-api/customers/declaration-status

API used to get the declaration status to check whether an accepted declaration already exists.

Headers

Name	Required	Description
Authorization	✅	Bearer token
Content-Type	✅	application/json

Query Parameters

Name	Required	Description
provider	✅	Name of the provider being used (for example: '1Invoice').
taxCode	✅	Seller's tax code (for example: '00883243241').
sorting		Sort by field (for example: 'creationTime').
sortType		Sort type (DESCEND: descending, ASCEND: ascending).
formDate		Issued from date (for example: '2024-12-31').
toDate		Issued to date (for example: '2025-08-11').
taxAuthorityFeedback		Tax authority feedback (1: Received, 2: Not received, 3: Accepted, 4: Not accepted).

Response

Name	Description
data[].id	Declaration id
data[].formality	Declaration type, 1: Registration, 2: Change
data[].taxCode	Seller's tax code
data[].taxAuthorityFeedback	Tax authority feedback (1: Received, 2: Not received, 3: Accepted, 4: Not accepted)
data[].dateCreate	Creation date, ISO 8601 format
data[].status	Declaration status, 0: Not sent, 1: Sent
data[].dateSign	Signing date, ISO 8601 format

note

This endpoint is called directly (not in the /<provider>/... form); the provider is passed via the provider query parameter.

1Invoice

curl --location 'https://stag-invoice-hub.1invoice.vn/core-api/customers/declaration-status?provider=1Invoice&taxCode=0106026495-998&sorting=creationTime&sortType=DESCEND&fromDate=2024-12-31&toDate=2025-08-12&taxAuthorityFeedback=3' \
--header 'authorization: Bearer <token>'

one-invoice

curl --location 'https://stag-invoice-hub.1invoice.vn/core-api/customers/declaration-status?provider=one-invoice&taxCode=0106026495-998&sorting=creationTime&sortType=DESCEND&fromDate=2025-12-31&toDate=2026-04-15&taxAuthorityFeedback=3' \
--header 'accept: application/json, text/plain, */*' \
--header 'authorization: Bearer <token>' \
--header 'x-tax-code: 0106026495-998'

Response

{
  "success": true,
  "data": [
    {
      "id": "3a1b94b4-04f9-d3d5-41a8-74dcba5c71d5",
      "formality": 2,
      "taxCode": "0106026495-998",
      "taxAuthorityFeedback": 3,
      "dateCreate": "2025-08-07T00:00:00",
      "status": 1,
      "dateSign": "2025-08-07T03:16:00.126946+00:00"
    },
    {
      "id": "3a1b8512-7a76-ba2c-a6a1-6f656276d399",
      "formality": 2,
      "taxCode": "0106026495-998",
      "taxAuthorityFeedback": 3,
      "dateCreate": "2025-08-04T00:00:00",
      "status": 1,
      "dateSign": "2025-08-04T02:25:13.474248+00:00"
    },
    {
      "id": "3a1b1e62-6618-109a-691f-e286f66c1c97",
      "formality": 2,
      "taxCode": "0106026495-998",
      "taxAuthorityFeedback": 3,
      "dateCreate": "2025-07-15T00:00:00",
      "status": 1,
      "dateSign": "2025-07-15T03:53:51.537946+00:00"
    }
  ]
}