API Methods 0.5
The Kumutu API currently supports XML output. If you wish to use JSON, please contact us for more information.
suppliers.get
http://api.kumutu.com/0.5/suppliers/get.xml
Description
Get all Suppliers with detailed information for each supplier.
Arguments
apikey
Required. Your API application key. See here for more details.
country
Filters the returned suppliers by associated country (ISO 3166 1 2 code).
region
Filters the returned suppliers by associated Region ID.
activity
Filters the returned suppliers by associated Activity ID.
activitytype
Using the activity type ID, only show suppliers for a specific category.
supplier
Using the supplier ID, only show information for that supplier.
HTTP Method
GET
HTTP Get Example
GET http://api.kumutu.com/0.5/suppliers/get.xml?apikey=1234&supplier=100001&country=GB®ion=4005&activity=1000001 HTTP/1.1
suppliers.removed
http://api.kumutu.com/0.5/suppliers/removed.xml
Description
Get all Suppliers that have been removed from Kumutu.
Arguments
apikey
Required. Your API application key. See here for more details.
country
Filters the returned suppliers by associated country (ISO 3166 1 2 code).
region
Filters the returned suppliers by associated Region ID.
activity
Filters the returned suppliers by associated Activity ID.
activitytype
Using the activity type ID, only show suppliers for a specific category.
supplier
Using the supplier ID, only show information for that supplier.
modified
Get only suppliers that have been modified in past number of hours.
HTTP Method
GET
HTTP Get Example
GET http://api.kumutu.com/0.5/suppliers/removed.xml?apikey=1234&supplier=100001&country=GB®ion=4005&activity=1000001 HTTP/1.1
activities.get
http://api.kumutu.com/0.5/activities/get.xml
Description
Get all Activities with detailed information for each activity.
Arguments
apikey
Required. Your API application key. See here for more details.
activity
Using the activity ID, only show a single activity.
country
Filters the returned activities by country (ISO 3166 1 2 code).
activitytype
Using the activity type ID, only show activities for a specific category.
supplier
Using the supplier ID, only show Activities for that supplier.
HTTP Method
GET
HTTP Get Example
GET http://api.kumutu.com/0.5/activities/get.xml?apikey=1234&country=GB&activity=1000001&supplier=100001 HTTP/1.1
activityTypes.get
http://api.kumutu.com/0.5/activityTypes/get.xml
Description
Retrieve a list of all supported Activity Types (e.g. Snowboarding, Kite Surfing) along with their ID and short name used by other methods
Arguments
apikey
Required. Your API application key. See here for more details.
HTTP Method
GET
HTTP Get Example
GET http://api.kumutu.com/0.5/activityTypes/get.xml?apikey=1234& HTTP/1.1
countries.get
http://api.kumutu.com/0.5/countries/get.xml
Description
Retrieve a list of all countries supported by Kumutu including the country ID, ISO, name, and short name used by other methods.
Arguments
apikey
Required. Your API application key. See here for more details.
region
Retrieve a list of only local regions using a true/false string (default: false).
HTTP Method
GET
HTTP Get Example
GET http://api.kumutu.com/0.5/countries/get.xml?apikey=1234®ion=true HTTP/1.1
regions.get
http://api.kumutu.com/0.5/regions/get.xml
Description
Retrieve a list of all country regions supported by Kumutu.
Arguments
apikey
Required. Your API application key. See here for more details.
global
Retrieve a list of only global regions by using a true/false string (default: false).
HTTP Method
GET
HTTP Get Example
GET http://api.kumutu.com/0.5/regions/get.xml?apikey=1234&global=true HTTP/1.1
reviews.get
http://api.kumutu.com/0.5/reviews/get.xml
Description
Retrieve a list of all reviews given to a supplier.
Arguments
apikey
Required. Your API application key. See here for more details.
supplier
Required. The supplier ID of the supplier to receive reviews for.
limit
The maximum number of reviews to receive. (default: 10)
HTTP Method
GET
HTTP Get Example
GET http://api.kumutu.com/0.5/reviews/get.xml?apikey=1234&supplier=100001&limit=10 HTTP/1.1
API Methods 0.4
The Kumutu API currently supports XML and JSON output. To use JSON, simply substitute .json for .xml in any of the methods below.
suppliers.get
http://api.kumutu.com/0.4/suppliers/get.xml
Description
Get all Suppliers with detailed information for each supplier.
Arguments
apikey
Required. Your API application key. See here for more details.
country
Filters the returned suppliers by associated country (ISO 3166 1 2 code).
region
Filters the returned suppliers by associated Region ID.
activity
Filters the returned suppliers by associated Activity ID.
activitytype
Using the activity type ID, only show activities for a specific category.
HTTP Method
GET
HTTP Get Example
GET http://api.kumutu.com/0.4/suppliers/get.xml?apikey=&supplier=&country=GB®ion=&activity= HTTP/1.1
activities.get
http://api.kumutu.com/0.4/activities/get.xml
Description
Get all Activities with detailed information for each activity.
Arguments
apikey
Required. Your API application key. See here for more details.
activity
Using the activity ID, only show a single activity.
country
Filters the returned activities by country (ISO 3166 1 2 code).
activitytype
Using the activity type ID, only show activities for a specific category.
supplier
Using the supplier ID, only show Activities for that supplier.
HTTP Method
GET
HTTP Get Example
GET http://api.kumutu.com/0.4/activities/get.xml?apikey=&country=GB&activity=&supplier= HTTP/1.1
activityTypes.get
http://api.kumutu.com/0.4/activityTypes/get.xml
Description
Retrieve a list of all supported Activity Types (e.g. Snowboarding, Kite Surfing) along with their ID and short name used by other methods
Arguments
apikey
Required. Your API application key. See here for more details.
HTTP Method
GET
countries.get
http://api.kumutu.com/0.4/countries/get.xml
Description
Retrieve a list of all countries supported by Kumutu including the country ID, ISO, name, and short name used by other methods.
Arguments
apikey
Required. Your API application key. See here for more details.
region
Retrieve a list of only local regions using a true/false string (default: false).
HTTP Method
GET
HTTP Get Example
GET http://api.kumutu.com/0.4/countries/get.xml?apikey=®ion=true HTTP/1.1
regions.get
http://api.kumutu.com/0.4/regions/get.xml
Description
Retrieve a list of all country regions supported by Kumutu.
Arguments
apikey
Required. Your API application key. See here for more details.
global
Retrieve a list of only global regions by using a true/false string (default: false).
HTTP Method
GET
HTTP Get Example
GET http://api.kumutu.com/0.4/regions/get.xml?apikey=&global=true HTTP/1.1
API Methods 0.3
suppliers.get
http://api.kumutu.com/0.3/suppliers/list.xml
Description
Get all Suppliers with detailed information for each supplier. Filtered by arguments.
Arguments
ApiKey
Your API application key. See here for more details.
Country
Filters the returned suppliers by associated country (ISO 3166 1 2 code).
Region
Filters the returned suppliers by associated Region ID.
Activity
Filters the returned suppliers by associated Activity ID.
HTTP Method
GET
HTTP Get Example
GET http://kumutu.com/api/suppliers/list.xml?apiKey=&country=GB®ion=&activity= HTTP/1.1
activities.get
http://api.kumutu.com/0.3/activities/list.xml
Description
Get all Activities with detailed information for each activity. Filtered by arguments.
Arguments
ApiKey
Your API application key. See here for more details.
Country
Filters the returned activities by country (ISO 3166 1 2 code).
Activity
Using the activity ID, only show a single activity.
Supplier
Using the supplier ID, only show Activities for that supplier.
HTTP Method
GET
HTTP Get Example
GET http://kumutu.com/api/activities/list.xml?apiKey=&country=GB&activity=&supplier= HTTP/1.1
activityTypes.getAll
http://api.kumutu.com/0.3/activityTypes/list.xml
Description
Retrieve a list of all supported Activity Types (e.g. Snowboarding, Kite Surfing) along with their ID used by other methods
Arguments
ApiKey
Your API application key. See here for more details.
HTTP Method
GET
countries.getAll
http://api.kumutu.com/0.3/countries/list.xml
Description
Retrieve a list of all countries supported by Kumutu including the country ISO used by other methods.
Arguments
ApiKey
Your API application key. See here for more details.
HTTP Method
GET
countriesRegions.getAll
http://api.kumutu.com/0.3/countries/regions.xml
Description
Retrieve a list of all countries supported by Kumutu including the regions associated with each country.
Arguments
ApiKey
Your API application key. See here for more details.
HTTP Method
GET
regions.getAll
http://api.kumutu.com/0.3/regions/list.xml
Description
Retrieve a list of all country regions supported by Kumutu.
Arguments
ApiKey
Your API application key. See here for more details.
HTTP Method
GET
regionsGlobal.getAll
http://api.kumutu.com/0.3/regions/global.xml
Description
Retrieve a list of the top level global regions supported by Kumutu including their region ID.
Arguments
ApiKey
Your API application key. See here for more details.
HTTP Method
GET
Error Codes
403
Forbidden - Authentication Rejected.
Description
Error triggered when authentication has been rejected, possibly due to incorrect apikey.
Example Response
<Error Code="403" Request="/0.4/countries/get.xml">Forbidden - Authentication Rejected.</Error>
HTTP status
500
1001
Version does not exist.
Description
Error triggered when API version requested does not exist.
Example Response
<Error Code="1001" Request="/0.2/countries/get.xml">Version does not exist.</Error>
HTTP status
500
1002
Unknown output file.
Description
Error triggered when xml output file cannot be located.
Example Response
<Error Code="403" Request="/0.4/countries/get.xml">Unknown output file.</Error>
HTTP status
500
1003
Unrecognised method.
Description
Error triggered when API method requested does not exist.
Example Response
<Error Code="403" Request="/0.4/countries/getAllRegions.xml">Unrecognised method.</Error>
