BeaconX e-Invoice API
  1. B2C Receipt
BeaconX e-Invoice API
  • BeaconX e-Invoice API Documentation
  • API Endpoints
    • B2B e-Invoicing
      • Create Document(s)
      • Cancel Document
      • Void Document
      • Unvoid Document
      • Create Invoice from Receipt
      • Check Status
      • Embed QR Code
      • Invoice Reversal
      • Update Reference Number
    • B2C Receipt
      • Retrieve Receipt
        GET
      • Search Receipts
        POST
      • Create a Receipt
        POST
      • Update existing Receipt
        PUT
      • Void a Receipt
        GET
      • Void Multiple Receipts
        POST
      • UnVoid a Receipt
        GET
      • Create Multiple Receipts (Bulk)
        POST
      • Receipt Reversal
        POST
      • Update Reference Number
        POST
      • Check Status
        POST
      • Get Validated Receipts
        POST
    • TaxPayer
      • Validate Tax Payer
      • Sync Tax Payer Master List
      • Identity
      • Validate SSM
      • Search TIN
    • Lists
      • Get list of all Classification Codes
  1. B2C Receipt

Check Status

POST
/receipts/status
Retrieves status of multiple receipts. Either a list of reference_number or invoice_number array to be provided to search.
Possible values for status:
Valid - This receipt is valid for claim / to be consolidated
Refunded - This is a Refund Receipt / CN
Claimed - This receipt has been claimed for eInvoice
Consolidated - This receipt has consolidated
Reversed - This receipt has been reversed by a Refund Receipt that references this receipt as the original
Void - This receipt is voided

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Example
{
    "invoice_number": [
        "RCPT001",
        "RCPT002",
        "RCPT003",
        "RCPT004",
        "RCPT005"
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://einvoice-api.beaconx.com.my/receipts/status' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "invoice_number": [
        "RCPT001",
        "RCPT002",
        "RCPT003",
        "RCPT004",
        "RCPT005"
    ]
}'

Responses

🟢200Success
application/json
Body

Example
{
    "status": "OK",
    "message": "",
    "meta": {
        "count": 1,
        "limit": 1000
    },
    "data": [
        {
            "reference_number": "RCPT001",
            "invoice_number": "RCPT001",
            "status": "Valid"
        },
        {
            "reference_number": "RCPT002",
            "invoice_number": "RCPT002",
            "status": "Refunded"
        },
        {
            "reference_number": "RCPT003",
            "invoice_number": "RCPT003",
            "status": "Claimed"
        },
        {
            "reference_number": "RCPT004",
            "invoice_number": "RCPT004",
            "status": "Consolidated"
        },
        {
            "reference_number": "RCPT005",
            "invoice_number": "RCPT005",
            "status": "Reversed"
        }
    ]
}
Modified at 2025-10-14 06:29:18
Previous
Update Reference Number
Next
Get Validated Receipts
Built with