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

Search TIN

GET
/taxpayer/search/tin
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

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/taxpayer/search/tin?name=ABC COMPANY SDN. BHD.' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

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-04-16 03:06:06
Previous
Validate SSM
Next
Get list of all Classification Codes
Built with