This s a documentation page for our shiny new REST API - you weren't meant to find it. This API isn't ready for public use yet. We're chopping and changing it a LOT as we grow it. So if you build something that uses it then it's very likely to break in a future update. Don't say you weren't warned!
URL: | https://api.kashflow.com/v2/countries/vatrates |
Method(s): | get |
Response Formats: | JSON, XML |
Description: | This method allows to retrieve vatrates for countries. The data returned by api is not user specific but it’s global data shared among all users. |
Parameters
Name | Type | Description |
---|---|---|
CountryCode | String | 2 digit ISO code for country |
CountryName | String | Name of Country |
Vat Rate details | ||
SuperReducedRate | Numeric Array | Reduced vatrate |
ReducedRate | Numeric Array | Reduced vatrate |
ParkingRate | Numeric Array | Parking vatrate |
StandardRate | Numeric Array | Standard vatrate |
GET Operation
GET of vatrates for countries setup for Kashflow.URL : /countries/vatrates?date={date}
- This will return vatrates of countries for specific date applicable for that date. It will not return vatrates those are expired and/or yet to start. for eg. suppose vatrates data is recorded for dates 2nd Feb 2014 and 10th Feb 2014. If vatrates data is requested for date 5th Feb 2014 then, vatrates for 2nd Feb 2014 will be returned.
- Latest (current) vatrates will be returned in case start date is not specified or specified as NULL
- date parameter must be in YYYYMMDD format
Example response for GET of countries vatrates
[{
"CountryName": "Afghanistan",
"CountryCode": "AF",
"VatRates": {
"SuperReducedRate": [456.3400,
0.5670],
"ReducedRate": [4.0500,
12.7890],
"StandardRate": [6.3400],
"ParkingRate": [34.8500]
}
},
{
"CountryName": "Argentina",
"CountryCode": "AR",
"VatRates": {
"SuperReducedRate": [0.5670],
"ReducedRate": [456.3400,
12.7890],
"StandardRate": [4.3000],
"ParkingRate": [4.0500]
}
},
{
"CountryName": "Armenia",
"CountryCode": "AM",
"VatRates": {
"SuperReducedRate": [456.3400,
0.5670],
"ReducedRate": [4.0500,
12.7890],
"StandardRate": [4.3000],
"ParkingRate": []
}
},
{
"CountryName": "Austria",
"CountryCode": "AT",
"VatRates": {
"SuperReducedRate": [456.3400,
0.5670],
"ReducedRate": [4.0500,
12.7890],
"StandardRate": [2.3000],
"ParkingRate": []
}
},
{
"CountryName": "Azerbaijan",
"CountryCode": "AZ",
"VatRates": {
"SuperReducedRate": [],
"ReducedRate": [],
"StandardRate": [3.3000],
"ParkingRate": []
}
},
{
"CountryName": "Barbados",
"CountryCode": "BB",
"VatRates": {
"SuperReducedRate": [456.3400,
0.5670],
"ReducedRate": [12.7890,
4.0500],
"StandardRate": [4.0000],
"ParkingRate": []
}
},
{
"CountryName": "Belize",
"CountryCode": "BZ",
"VatRates": {
"SuperReducedRate": [],
"ReducedRate": [],
"StandardRate": [7.3000],
"ParkingRate": []
}
},
{
"CountryName": "Canada",
"CountryCode": "CA",
"VatRates": {
"SuperReducedRate": [],
"ReducedRate": [],
"StandardRate": [7.3000],
"ParkingRate": []
}
}]