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 | Requirement |
|---|---|---|---|---|
| tin | Number | The Tax Identification Number to get the validity of the tin. | C25845632020 | Mandatory |
| idType | Query | NRIC, Passport number, Business registration number, army number | NRIC ID type example: NRIC Passport ID type example: PASSPORT BRN ID type example: BRN Army ID type example: ARMY |
Mandatory |
| 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 |
Mandatory |
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.