BeaconX e-Invoice API
  1. TaxPayer
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
      • Search Receipts
      • Create a Receipt
      • Update existing Receipt
      • Void a Receipt
      • Void Multiple Receipts
      • UnVoid a Receipt
      • Send a Receipt (Email / WhatsApp)
      • Download Receipts Report
      • Create Multiple Receipts (Bulk)
      • Receipt Reversal
      • Update Reference Number
      • Check Status
    • TaxPayer
      • Validate Tax Payer
        POST
      • Sync Tax Payer Master List
        POST
      • Identity
        GET
      • Validate SSM
        POST
      • Search TIN
        GET
    • Lists
      • Get list of all Classification Codes
  1. TaxPayer

Validate SSM

Testing
POST
/ssm/validate
This is an add-on module and must be enabled in order to work.
This endpoint allows retrieval of SSM information on Company Name and Registration Number. It caters for both ROC (Sdn Bhd and Bhd) and ROB (Sole Proprietors, Partnerships).

Request

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

Example
[
    "202301022840",
    "200503034120",
    "200703153397",
    "202204141107",
    "198603045490",
    "201903003770",
    "202101023888",
    "202401023125",
    "200101023697"
]

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/ssm/validate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '[
    "202301022840",
    "200503034120",
    "200703153397",
    "202204141107",
    "198603045490",
    "201903003770",
    "202101023888",
    "202401023125",
    "200101023697"
]'

Responses

🟢200OK
application/json
Body

Examples
{
    "status": "OK",
    "message": "",
    "meta": {
        "count": 9,
        "success": 8,
        "fail": 1
    },
    "data": [
        {
            "keyword": "202301022840",
            "status": "valid",
            "name": "HWAMDA SALES & SERVICES  SDN. BHD.",
            "old_brn": "1516763-W",
            "new_brn": "202301022840",
            "message": ""
        },
        {
            "keyword": "200503034120",
            "status": "valid",
            "name": "JEZA ELECTRICAL AND MECHANICAL",
            "old_brn": "JM0424878-H",
            "new_brn": "200503034120",
            "message": ""
        },
        {
            "keyword": "200703153397",
            "status": "valid",
            "name": "GUJIN ENTERPRISE",
            "old_brn": "PG0204755-H",
            "new_brn": "200703153397",
            "message": ""
        },
        {
            "keyword": "202204141107",
            "status": "unsupported",
            "name": "",
            "old_brn": "",
            "new_brn": "",
            "message": "Search for LLP businesses are not supported yet."
        },
        {
            "keyword": "198603045490",
            "status": "valid",
            "name": "WENG ENGINEERING WORKS",
            "old_brn": "IP0028188-U",
            "new_brn": "198603045490",
            "message": ""
        },
        {
            "keyword": "201903003770",
            "status": "valid",
            "name": "SYAIFMAR ENTERPRISE",
            "old_brn": "SA0503565-H",
            "new_brn": "201903003770",
            "message": ""
        },
        {
            "keyword": "202101023888",
            "status": "valid",
            "name": "TMETAL PRECISION SDN. BHD.",
            "old_brn": "1424188-M",
            "new_brn": "202101023888",
            "message": ""
        },
        {
            "keyword": "202401023125",
            "status": "valid",
            "name": "OMISO GLOBAL (M)  SDN. BHD.",
            "old_brn": "1568974-X",
            "new_brn": "202401023125",
            "message": ""
        },
        {
            "keyword": "200101023697",
            "status": "valid",
            "name": "LIFTING TACKLE AND HARDWARE SDN. BHD.",
            "old_brn": "559455-X",
            "new_brn": "200101023697",
            "message": ""
        }
    ]
}
Modified at 2025-05-22 06:36:02
Previous
Identity
Next
Search TIN
Built with