Last Updated: 20th September 2024

Validate Tax Payer

POST

/taxpayer/validate

This endpoint allows source systems to perform validation of TIN and NRIC with LHDN.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Header Params

Body Params application/json

Example

[
    {"id_type": "BRN", "id_number": "197201001581", "tin": "C865879100"},
    {"id_type": "BRN", "id_number": "197201001581", "tin": "C86587910"},
    {"id_type": "BRN", "id_number": "EI00000000030", "tin": "C4865297000"}
]

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://einvoice-api.beaconx.com.my/taxpayer/validate' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '[
    {"id_type": "BRN", "id_number": "197201001581", "tin": "C865879100"},
    {"id_type": "BRN", "id_number": "197201001581", "tin": "C86587910"},
    {"id_type": "BRN", "id_number": "EI00000000030", "tin": "C4865297000"}
]'

Responses

🟢200OK

application/json

Body

Example

{"status":"OK","message":"","data":[{"id_type":"BRN","id_number":"197201001581","tin":"C865879100","status":"success"},{"id_type":"BRN","id_number":"EI00000000030","tin":"C4865297000","status":"success"}]}

Modified at 2025-05-22 06:31:08

Check Status

Sync Tax Payer Master List