Validate SSM - BeaconX e-Invoice API

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

object {0}

Example

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

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

status

string

required

Returns "OK" when endpoint is functioning.

message

string

required

Not used

meta

object

required

Summary information on data returned

count

integer

required

Total BRN submitted for validation

success

integer

required

Total BRN successfully validated

fail

integer

required

data

array [object {6}]

required

keyword

string

required

status

string

required

name

string

required

old_brn

string

required

new_brn

string

required

message

string

required

Examples

SuccessException

{
  "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": ""
    }
  ]
}