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

Retrieve Receipt

GET
/receipts/{reference_number}

Request

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

Header Params

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 GET 'https://einvoice-api.beaconx.com.my/receipts/OUTLET-POSID-11321' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK
application/json
Body

Examples
{
    "status": "OK",
    "message": "",
    "data": {
        "type": "01",
        "buyer": {
            "tin": "",
            "name": "",
            "email": "",
            "address": "",
            "contact": "",
            "id_number": "",
            "sst_number": "",
            "membership_id": ""
        },
        "items": [
            {
                "id": "0",
                "code": "0000000077205",
                "gst_rate": 0,
                "quantity": 1,
                "subtotal": 550,
                "ttx_rate": 0,
                "hvgt_rate": 0,
                "lvst_rate": 0,
                "gst_amount": 0,
                "ttx_amount": 0,
                "unit_price": 550,
                "description": "0000000077205",
                "hvgt_amount": 0,
                "lvst_amount": 0,
                "measurement": "",
                "discount_rate": 0,
                "classification": "",
                "total_excl_tax": 0,
                "total_incl_tax": 27.5,
                "discount_amount": 550,
                "long_description": "",
                "sales_tax_amount": 0,
                "tax_exempt_amount": 0,
                "service_fee_amount": 0,
                "service_tax_amount": 27.5
            }
        ],
        "pos_id": "350006",
        "source": "",
        "status": "valid",
        "quantity": 0,
        "rounding": 0,
        "sst_rate": 0,
        "subtotal": 0,
        "issued_at": "2025-04-29",
        "gst_amount": 0,
        "sst_amount": 0,
        "ttx_amount": 0,
        "hvgt_amount": 0,
        "lvst_amount": 0,
        "outlet_code": "66618477",
        "footer_notes": "",
        "currency_code": "MYR",
        "currency_rate": 1,
        "discount_rate": 0,
        "payment_terms": "",
        "invoice_number": "RCPT00220251010",
        "payment_method": "",
        "total_excl_tax": 0,
        "total_incl_tax": 577.5,
        "discount_amount": 0,
        "reference_number": "RCPT00220251010",
        "sales_tax_amount": 0,
        "service_fee_rate": 0,
        "total_net_amount": 577.5,
        "total_tax_amount": 27.5,
        "prepayment_amount": 0,
        "service_fee_amount": 0,
        "service_tax_amount": 27.5,
        "prepayment_datetime": "2025-04-29",
        "total_payable_amount": 577.5,
        "prepayment_reference_number": "",
        "original_einvoice_ref_number": "",
        "suppliers_bank_account_number": "",
        "id": "9eea0f5a-41b6-41f8-9591-515cb1e0ca72",
        "url": "https://api.beaconx.com.my/beacon/12345/9eea0f5a-41b6-41f8-9591-515cb1e0ca72",
        "document": {}
    }
}
Modified at 2025-09-22 04:25:55
Previous
Update Reference Number
Next
Search Receipts
Built with