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&region=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&region=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&region=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&region=&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=&region=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&region=&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>

HTTP status

500