Load products from the Rezdy Marketplace. Use this service when acting as an agent, to find products that are available for you to book.

Request

GET https://api.rezdy.com/v1/products/marketplace

Query parameters

Parameter name Value Description Additional
marketplaceRates boolean

marketplaceRates boolean, set to true to only return products with a marketplace rate.

negotiatedRates boolean

negotiatedRates boolean, set to true to only return products with a negotiated rate. If both marketplaceRates and negotiatedRates are true, all products with a rate will be returned

category array of int64, multiple occurances

category optional ids of categories you'd like to get products from. Multiple values allowed (&category=1&category=2)

language array of string, multiple occurances

languages optional, if set filters only products suitable for the specified languages. Multiple values are allowed (&language=en_au&language=sk). Format of the language is ISO 639 two-letter code with BCP 47 language variants, separated by underscore e.g. en_au. use only 2 letters code in order to search all language variants, e.g. en, will retrieve all variants en_au, en_us, ... It does not mean that a product description is necessarily in the specified language, but rather that a product is suitable for a customer speaking that particular language.

latitude double

latitude Latitude to sort results from. When sending a center point lat/lng, we will return products up to 500km away, ordered by distance from that point.

longitude double

longitude Longitude to sort results from.

minQuantity int32

minQuantity Minimum availability for the returned products

startDate string

startDate Optional date in ISO 8601 format, e.g. 2014-03-01T00:00:00Z If a date is sent, this will only return products that are available within

automatedPayment boolean

automatedPayment If true, this will only return products with an automated commission payment.

updatedSince string

updatedSince Optional date in ISO 8601 format, e.g. 2014-03-01T00:00:00Z If a date is sent, this will only return products that were updated since the specified date. Note that when a product is created, it will be created in a number of steps, so the dateUpdated field is ALWAYS set. Therefore using the updatedSince will include all products that have been updated and/or created since the specified date/time.

search string

search String to search for. It will be searched in product name, product code and supplier company name.

supplierId int64

supplierId Optional supplier id to limit results to a single supplier's products.

supplierAlias string

supplierAlias Optional supplier alias to limit results to a single supplier's products. The Alias is part of the supplier's booking form URL, for example alias is "demo" in https://demo.rezdy.com

limit int32

limit How many results are returned per request. Maximum is 100, which also a default, when not specified.

offset int32

offset Offset of the first result to return. Default to 0.

tags array of string, multiple occurances

Tags belonging to a product. Each specified tag should be in the form TAGTYPE:TAGVALUE.
Valid TAGTYPES are

  • TYPE
  • CATEGORY
  • INTEREST
  • INTENSITY
  • SKILL_LEVEL
  • AGE
  • ACCESSIBILITY
  • SUITABILITY
e.g. ACCESSIBILITY:VISION_IMPAIRED

Response

The following HTTP status codes may be returned, optionally with a response resource.

Status code Description Resource
200 OK

successful operation

ResponseProductList

Explore this API

apiKey Enter your API Key to try this call
marketplaceRates

marketplaceRates boolean, set to true to only return products with a marketplace rate.

negotiatedRates

negotiatedRates boolean, set to true to only return products with a negotiated rate. If both marketplaceRates and negotiatedRates are true, all products with a rate will be returned

category

category optional ids of categories you'd like to get products from. Multiple values allowed (&category=1&category=2)

language

languages optional, if set filters only products suitable for the specified languages. Multiple values are allowed (&language=en_au&language=sk). Format of the language is ISO 639 two-letter code with BCP 47 language variants, separated by underscore e.g. en_au. use only 2 letters code in order to search all language variants, e.g. en, will retrieve all variants en_au, en_us, ... It does not mean that a product description is necessarily in the specified language, but rather that a product is suitable for a customer speaking that particular language.

latitude

latitude Latitude to sort results from. When sending a center point lat/lng, we will return products up to 500km away, ordered by distance from that point.

longitude

longitude Longitude to sort results from.

minQuantity

minQuantity Minimum availability for the returned products

startDate

startDate Optional date in ISO 8601 format, e.g. 2014-03-01T00:00:00Z If a date is sent, this will only return products that are available within

automatedPayment

automatedPayment If true, this will only return products with an automated commission payment.

updatedSince

updatedSince Optional date in ISO 8601 format, e.g. 2014-03-01T00:00:00Z If a date is sent, this will only return products that were updated since the specified date. Note that when a product is created, it will be created in a number of steps, so the dateUpdated field is ALWAYS set. Therefore using the updatedSince will include all products that have been updated and/or created since the specified date/time.

search

search String to search for. It will be searched in product name, product code and supplier company name.

supplierId

supplierId Optional supplier id to limit results to a single supplier's products.

supplierAlias

supplierAlias Optional supplier alias to limit results to a single supplier's products. The Alias is part of the supplier's booking form URL, for example alias is "demo" in https://demo.rezdy.com

limit

limit How many results are returned per request. Maximum is 100, which also a default, when not specified.

offset

offset Offset of the first result to return. Default to 0.

tags

Tags belonging to a product. Each specified tag should be in the form TAGTYPE:TAGVALUE.
Valid TAGTYPES are

  • TYPE
  • CATEGORY
  • INTEREST
  • INTENSITY
  • SKILL_LEVEL
  • AGE
  • ACCESSIBILITY
  • SUITABILITY
e.g. ACCESSIBILITY:VISION_IMPAIRED

Response Content-Type
Try it out!