Validate Taxpayer's TIN

This API allows taxpayer's ERP system to validate specific Tax Identification Number (TIN) before adding this number to an invoice and issuing the invoice.

Full e-Invoice API list Submit Documents

Overview

Validate Taxpayer’s TIN API is used to validate specific Tax Identification Number (TIN) before adding this number to an invoice and issuing the invoice.

Note! when you are logged in as intermediary, permissions that are granted by the taxpayer will be applied on your profile and this will control the functionalities that you'll be able to executed on behalf of the taxpayer you are representing.

Signature

This is REST based API that validates TIN.

Signature: GET /api/v1.0/taxpayer/validate/{tin}?idType={idType}&idValue={idValue}

Inputs

This API accepts standard e-Invoice API header parameters for authenticated call except for the one defined below:

Input parameter Type Description Value example
tin Number The Tax Identification Number to get the validity of the tin. C25845632020
idType Query (NRIC, Passport number, Business registration number, army number) NRIC
idValue Query The actual value of the ID Type selected. For example, if NRIC selected as ID Type, then pass the NRIC value here. BRN example: 201901234567
NRIC example: 770625015324
Passport number example: A12345678
Army number example: 551587706543

Outputs

Successful Response

This API returns HTTP status code 200.

Error Response

This API returns HTTP status code 400 (BadArgument) if the TIN or any of the input parameters does not match the argument structure.
This API returns HTTP status code 404 (Not Found) if that TIN and ID combination cannot be found or are considered invalid.