production
development
https://apisandbox.iras.gov.sg/iras/sb
Custom Gateway API Endpoint
Paths
/CalPubListedCompanyShares
post /CalPubListedCompanyShares
Calculate stamp duty for transference of public listed company shares
Client ID
X-IBM-Client-Id
(apiKey located in header)
Client Secret
X-IBM-Client-Secret
(apiKey located in header)
christopher_shwe@iras.gov.sg
body
Optional in body
object
{
"schema": {
"type": "object",
"properties": {
"clientID": {
"type": "string"
},
"numberOfSharesTransferred": {
"type": "number",
"multipleOf": 1
},
"valuePerShare": {
"type": "number"
},
"consideration": {
"type": "number"
},
"transferenceDate": {
"type": "string",
"format": "date"
}
},
"additionalProperties": false,
"required": [
"clientID",
"numberOfSharesTransferred",
"valuePerShare",
"consideration",
"transferenceDate"
]
}
}
Content-Type
Optional in header
string
application/json
Accept
Optional in header
string
application/json
200
Example Request
Example Response
POST https://apisandbox.iras.gov.sg/iras/sb/SD/CalPubListedCompanyShares
/CalIndustrialSSD
post /CalIndustrialSSD
Seller Stamp Duty for Industrial Property
Client ID
X-IBM-Client-Id
(apiKey located in header)
Client Secret
X-IBM-Client-Secret
(apiKey located in header)
christopher_shwe@iras.gov.sg
body
Optional in body
object
Content-Type
Optional in header
string
application/json
Accept
Optional in header
string
application/json
200
Example Request
Example Response
POST https://apisandbox.iras.gov.sg/iras/sb/SD/CalIndustrialSSD
/CalPropertyBSD
post /CalPropertyBSD
Buyer Stamp Duty for Properties
Client ID
X-IBM-Client-Id
(apiKey located in header)
Client Secret
X-IBM-Client-Secret
(apiKey located in header)
christopher_shwe@iras.gov.sg
body
Optional in body
object
{
"schema": {
"type": "object",
"properties": {
"clientID": {
"type": "string"
},
"value": {
"type": "number"
},
"documentDate": {
"type": "string",
"format": "date"
}
},
"additionalProperties": false,
"required": [
"value",
"documentDate",
"clientID"
]
}
}
Content-Type
Optional in header
string
application/json
Accept
Optional in header
string
application/json
200
{
"schema": {
"type": "object",
"properties": {
"data": {
"type": "number"
},
"returnCode": {
"type": "number",
"multipleOf": 1
},
"info": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"messageCode": {
"type": "integer"
},
"fieldInfoList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"message": {
"type": "string"
{
"schema": {
"type": "object",
"properties": {
"data": {
"type": "number"
},
"returnCode": {
"type": "number",
"multipleOf": 1
},
"info": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"messageCode": {
"type": "integer"
},
"fieldInfoList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
}
}
}
},
"required": [
"returnCode"
]
},
"examples": {
"application\/json": {
"data": 150,
"returnCode": 10
}
}
}
x
Example Request
Example Response
POST https://apisandbox.iras.gov.sg/iras/sb/SD/CalPropertyBSD
/CalPrivateCompanyShares
post /CalPrivateCompanyShares
Private Company Shares Transfer Stamp Duty
Calculating stamp duties for private companies with established accounts.
Client ID
X-IBM-Client-Id
(apiKey located in header)
Client Secret
X-IBM-Client-Secret
(apiKey located in header)
christopher_shwe@iras.gov.sg
body
Optional in body
object
{
"schema": {
"type": "object",
"properties": {
"clientID": {
"type": "string"
},
"ordinaryShares": {
"$ref": "#\/definitions\/PrivateCompanyShareInfo"
},
"preferenceShares": {
"$ref": "#\/definitions\/PrivateCompanyShareInfo"
},
"consideration": {
"type": "number"
},
"transferenceDate": {
"type": "string",
"format": "date"
}
},
"required": [
"consideration",
"transferenceDate",
"clientID"
],
"additionalProperties": false
}
}
Content-Type
Optional in header
string
application/json
Accept
Optional in header
string
application/json
200
Example Request
Example Response
POST https://apisandbox.iras.gov.sg/iras/sb/SD/CalPrivateCompanyShares
/CalMortgage
post /CalMortgage
Calculater Stamp Duty for Mortgages
Client ID
X-IBM-Client-Id
(apiKey located in header)
Client Secret
X-IBM-Client-Secret
(apiKey located in header)
christopher_shwe@iras.gov.sg
body
Optional in body
object
{
"schema": {
"type": "object",
"properties": {
"mortgageAmount": {
"type": "number"
},
"documentDate": {
"type": "string",
"format": "date"
},
"clientID": {
"type": "string"
}
},
"required": [
"mortgageAmount",
"documentDate",
"clientID"
]
}
}
Content-Type
Optional in header
string
application/json
Accept
Optional in header
string
application/json
200
{
"schema": {
"type": "object",
"properties": {
"returnCode": {
"type": "number",
"multipleOf": 1
},
"data": {
"type": "number"
},
"info": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"messageCode": {
"type": "integer"
},
"fieldInfoList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"message": {
"type": "string"
{
"schema": {
"type": "object",
"properties": {
"returnCode": {
"type": "number",
"multipleOf": 1
},
"data": {
"type": "number"
},
"info": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"messageCode": {
"type": "integer"
},
"fieldInfoList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
}
}
}
},
"required": [
"returnCode"
]
},
"examples": {
"application\/json": {
"data": 500,
"returnCode": 1
}
}
}
x
Example Request
/GetPropertyABSDRate
post /GetPropertyABSDRate
Obtain Additional Buyer Stamp Duty Rates for Property
Client ID
X-IBM-Client-Id
(apiKey located in header)
Client Secret
X-IBM-Client-Secret
(apiKey located in header)
christopher_shwe@iras.gov.sg
body
Optional in body
object
{
"schema": {
"type": "object",
"properties": {
"buyers": {
"type": "array",
"items": {
"$ref": "#\/definitions\/ABSDBuyer"
}
},
"purchaseType": {
"type": "number",
"multipleOf": 1
},
"documentDate": {
"type": "string",
"format": "date"
},
"clientID": {
"type": "string"
}
},
"required": [
"buyers",
"purchaseType",
"documentDate",
"clientID"
],
"additionalProperties": false
}
}
Content-Type
Optional in header
string
application/json
Accept
Optional in header
string
application/json
200
{
"schema": {
"type": "object",
"properties": {
"returnCode": {
"type": "number",
"multipleOf": 1
},
"data": {
"type": "number"
},
"info": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"messageCode": {
"type": "integer"
},
"fieldInfoList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"messasge": {
"type": "string"
{
"schema": {
"type": "object",
"properties": {
"returnCode": {
"type": "number",
"multipleOf": 1
},
"data": {
"type": "number"
},
"info": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"messageCode": {
"type": "integer"
},
"fieldInfoList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"messasge": {
"type": "string"
}
}
}
}
}
}
},
"required": [
"returnCode"
]
},
"examples": {
"application\/json": {
"data": 0.07,
"returnCode": 1
}
}
}
x
Example Request
Example Response
POST https://apisandbox.iras.gov.sg/iras/sb/SD/GetPropertyABSDRate
/CalPropertyResidentialSSD
post /CalPropertyResidentialSSD
Residential Seller Stamp Duty
Client ID
X-IBM-Client-Id
(apiKey located in header)
Client Secret
X-IBM-Client-Secret
(apiKey located in header)
christopher_shwe@iras.gov.sg
body
Optional in body
object
Content-Type
Optional in header
string
application/json
Accept
Optional in header
string
application/json
200
Example Request
Example Response
POST https://apisandbox.iras.gov.sg/iras/sb/SD/CalPropertyResidentialSSD
/CalNewPrivateCompanyShares
post /CalNewPrivateCompanyShares
Calculate stamp duty for newly incorporated private companies
Client ID
X-IBM-Client-Id
(apiKey located in header)
Client Secret
X-IBM-Client-Secret
(apiKey located in header)
christopher_shwe@iras.gov.sg
body
Optional in body
object
{
"schema": {
"type": "object",
"properties": {
"clientID": {
"type": "string"
},
"numberOfSharesTransferred": {
"type": "number",
"multipleOf": 1
},
"allotmentPrice": {
"type": "number"
},
"consideration": {
"type": "number"
},
"transferenceDate": {
"type": "string",
"format": "date"
}
},
"additionalProperties": false,
"required": [
"clientID",
"numberOfSharesTransferred",
"allotmentPrice",
"consideration",
"transferenceDate"
]
}
}
Content-Type
Optional in header
string
application/json
Accept
Optional in header
string
application/json
200
Example Request
Example Response
POST https://apisandbox.iras.gov.sg/iras/sb/SD/CalNewPrivateCompanyShares
/CalPropertyTenancy
post /CalPropertyTenancy
Stamp duty for Tenancy
Client ID
X-IBM-Client-Id
(apiKey located in header)
Client Secret
X-IBM-Client-Secret
(apiKey located in header)
christopher_shwe@iras.gov.sg
body
Optional in body
object
{
"schema": {
"type": "object",
"properties": {
"terms": {
"type": "array",
"items": {
"$ref": "#\/definitions\/tenancyTerm"
}
},
"premium": {
"type": "number"
},
"documentDate": {
"type": "string",
"format": "date"
},
"clientID": {
"type": "string"
}
},
"additionalProperties": false,
"required": [
"terms",
"premium",
"documentDate",
"clientID"
]
}
}
Content-Type
Optional in header
string
application/json
Accept
Optional in header
string
application/json
200
{
"schema": {
"type": "object",
"properties": {
"returnCode": {
"type": "number",
"multipleOf": 1
},
"info": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"mesageCode": {
"type": "integer"
},
"fieldInfoList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
{
"schema": {
"type": "object",
"properties": {
"returnCode": {
"type": "number",
"multipleOf": 1
},
"info": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"mesageCode": {
"type": "integer"
},
"fieldInfoList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
}
}
},
"data": {
"type": "object",
"properties": {
"stampDuty": {
"type": "number"
},
"AAR": {
"type": "number"
},
"dutiableAmount": {
"type": "number"
},
"dutyOnPremium": {
"type": "number"
},
"leaseDutyRate": {
"type": "number"
}
}
}
},
"required": [
"returnCode"
]
},
"examples": {
"application\/json": {
"returnCode": 10,
"data": {
"stampDuty": 100,
"AAR": 1000,
"dutiableAmount": 1000,
"dutyOnPremium": 100,
"leaseDutyRate": 0.004
}
}
}
}
x
Example Request
Example Response
POST https://apisandbox.iras.gov.sg/iras/sb/SD/CalPropertyTenancy
Definitions
{
"type": "object",
"properties": {
"startDate": {
"type": "string",
"format": "date"
},
"endDate": {
"type": "string",
"format": "date"
},
"monthlyRent": {
"type": "number"
},
"monthlyFurnitureFittings": {
"type": "number"
},
"monthlyServiceMaintenance": {
"type": "number"
},
"monthlyAdvertisingAndPromotion": {
"type": "number"
},
"otherMonthlyCharges": {
"type": "number"
}
},
"additionalProperties": false,
"required": [
"startDate",
"endDate"
]
}
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"acquisitionDate": {
"type": "string",
"format": "date"
},
"disposalDate": {
"type": "string",
"format": "date"
},
"clientID": {
"type": "string"
}
},
"required": [
"value",
"acquisitionDate",
"disposalDate",
"clientID"
]
}
{
"type": "object",
"properties": {
"nationality": {
"type": "string"
},
"existingPropertyCount": {
"type": "number",
"multipleOf": 1
}
},
"additionalProperties": false,
"required": [
"nationality",
"existingPropertyCount"
]
}
{
"type": "object",
"properties": {
"sharesTransferred": {
"type": "number",
"multipleOf": 1,
"default": 0
},
"NAVPerShare": {
"type": "number",
"default": 0
}
},
"required": [
"sharesTransferred",
"NAVPerShare"
],
"additionalProperties": false
}
{
"type": "object",
"properties": {
"returnCode": {
"type": "number",
"multipleOf": 1
},
"error": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"fieldErrors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"errorMsg": {
"type": "string"
}
}
}
}
}
},
"data": {
"type": "object",
"properties": {
"stampDuty": {
"type": "number"
},
"AAR": {
"type": "number"
},
"dutiableAmount": {
"type": "number"
},
"dutyOnPremium": {
"type": "number"
},
"leaseDutyRate": {
"type": "number"
}
}
}
},
"required": [
"returnCode"
]
}
{
"type": "object",
"properties": {
"returnCode": {
"type": "number",
"multipleOf": 1
},
"data": {
"type": "object",
"properties": {
"stampDuty": {
"type": "number"
},
"dutiableAmount": {
"type": "number"
},
"dutyRate": {
"type": "number"
}
}
},
"info": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"messageCode": {
"type": "integer"
},
"fieldInfoList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
}
}
}
},
"required": [
"returnCode"
]
}
{
"type": "object",
"properties": {
"returnCode": {
"type": "number",
"multipleOf": 1
},
"info": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"messageCode": {
"type": "integer"
},
"fieldInfoList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
}
}
},
"data": {
"type": "object",
"properties": {
"stampDuty": {
"type": "number"
},
"holdingPeriod": {
"type": "number"
},
"dutyRate": {
"type": "number"
}
}
}
},
"required": [
"returnCode"
]
}
{
"type": "object",
"properties": {
"clientId": {
"type": "string"
}
},
"required": [
"clientId"
]
}