Check Status

POST

/einvoices/status

This API endpoint returns status of documents with full details of each document. Each attribute adds on as an AND filter to the condition.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Example

{
    "reference_number": [
        "0101B2B01400",
        "123457"
    ],
    "outlet_code": [
        "A001",
        "B002"
    ],
    "direction": "received",
    "tax_payer_code": [
        "SUP001", "SUP010", "SUP099"
    ],
    "date_from": "2024-06-01",
    "date_to": "2024-06-14",
    "source": ["iserve"]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://einvoice-api.beaconx.com.my/einvoices/status' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reference_number": [
        "0101B2B01400",
        "123457"
    ],
    "outlet_code": [
        "A001",
        "B002"
    ],
    "direction": "received",
    "tax_payer_code": [
        "SUP001", "SUP010", "SUP099"
    ],
    "date_from": "2024-06-01",
    "date_to": "2024-06-14",
    "source": ["iserve"]
}'

Responses

🟢200Success

application/json

Body

Examples

Success (AR / Self-bill - Sent)Success (AP - Received)

{
    "status": "OK",
    "message": "",
    "data": [
        {
            "reference_number": "INV1234",
            "status": "valid",
            "lhdn_uin": "42S512YACQBRSRHYKBXBTGQG22",
            "lhdn_long_id": "YQH73576FY9VR57B",
            "lhdn_validated_at": "2015-02-13T14:20:00Z",
            "lhdn_validation_url": "https://preprod.myinvois.hasil.gov.my/42S512YACQBRSRHYKBXBTGQG22/share/YQH73576FY9VR57B",
            "email_notified_at": "2015-02-13T14:20:00Z",
            "message": [
                ""
            ]
        }
    ]
}

Modified at 2025-09-10 16:59:38

Create Invoice from Receipt

Embed QR Code