Partner API.

Server
channel.redeam.io
Server Variables
Fields
KeyIn
X-API-KeyHeader
Fields
KeyIn
X-API-SecretHeader

Retrieve a list of availabilities

Returns a list of availabilities.

Auth
Headers
X-Request-IDstring

Request ID for request tracking.

Path Params
product_idstring
supplier_idstring
Query String
endstring
startstring
rate_idstring
GET /suppliers/{supplier_id}/products/{product_id}/availabilities
curl --get \
--url 'https://channel.redeam.io/v1.2/suppliers/{supplier_id}/products/{product_id}/availabilities' \
--header 'X-Request-ID: {X-Request-ID}' \
--header 'X-API-Key: {X-API-Key}' \
--header 'X-API-Secret: {X-API-Secret}' \
--data end={end} \
--data start={start} \
--data rate_id={rate_id}
Copy
Responses application/json
200

Retrieve a list of availabilities

objectobject
availabilities5 fieldsobject

The availabilities matching the request

metaobject

Request meta data

reqIduuid

Request ID

400

Retrieve a list of availabilities

401

Retrieve a list of availabilities

Response
{
"availabilities": {
"byProduct": {
"availability": [
{
"capacity": 1,
"end": "2018-10-19T17:37:31-06:00",
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"maxCapacity": 100,
"start": "2018-10-19T17:37:31-06:00"
}
]
},
"byRate": {
"string": {
"availability": [
{
"capacity": 1,
"end": "2018-10-19T17:37:31-06:00",
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"maxCapacity": 100,
"start": "2018-10-19T17:37:31-06:00"
}
]
}
},
"expires": "2018-10-19T17:37:31-06:00",
"productId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"retrieved": "2018-10-19T17:37:31-06:00"
},
"meta": {
"reqId": "5fd78809-4700-46d7-8386-3b8738117f4d"
}
}
Copy

Retrieve a single availability

Checks the availability of a product.

Auth
Headers
X-Request-IDstring

Request ID for request tracking.

Path Params
product_idstring
supplier_idstring
Query String
atstring
qtyinteger
rate_idstring
GET /suppliers/{supplier_id}/products/{product_id}/availability
curl --get \
--url 'https://channel.redeam.io/v1.2/suppliers/{supplier_id}/products/{product_id}/availability' \
--header 'X-Request-ID: {X-Request-ID}' \
--header 'X-API-Key: {X-API-Key}' \
--header 'X-API-Secret: {X-API-Secret}' \
--data at={at} \
--data qty={qty} \
--data rate_id={rate_id}
Copy
Responses application/json
200

Retrieve a single availability

objectobject
availability5 fieldsobject

The availability matching the request

bookableboolean

A true value means a bookable availability is found

metaobject

Request meta data

reqIduuid

Request ID

400

Retrieve a single availability

401

Retrieve a single availability

404

Retrieve a single availability

Response
{
"availability": {
"capacity": 1,
"end": "2018-10-19T17:37:31-06:00",
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"maxCapacity": 100,
"start": "2018-10-19T17:37:31-06:00"
},
"bookable": true,
"meta": {
"reqId": "5fd78809-4700-46d7-8386-3b8738117f4d"
}
}
Copy

Create a booking

Creates a booking.

Auth
Headers
X-Request-IDstring

Request ID for request tracking.

Request Body
objectobject
booking15 fieldsobject

The booking

metaobject

Request meta data

reqIduuid

Request ID

POST /bookings
curl --request POST \
--url 'https://channel.redeam.io/v1.2/bookings' \
--header 'X-Request-ID: {X-Request-ID}' \
--header 'X-API-Key: {X-API-Key}' \
--header 'X-API-Secret: {X-API-Secret}' \
--data '{
"booking": {
"barcode": {
"format": "CODE128",
"value": "string"
},
"channelId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"customer": {
"email": "customer@gmail.com",
"firstName": "string",
"lastName": "string",
"phone": "(1) 212 555-1234"
},
"ext": {
"string": "string"
},
"holdExt": {
"string": "string"
},
"holdId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"items": [
{
"availabilityId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"ext": {
"string": "string"
},
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"priceId": "string",
"productId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"quantity": 1,
"rateId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"startTime": "2018-10-19T17:37:31-06:00",
"supplierId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"traveler": {
"age": 35,
"country": "USA",
"email": "traveler@gmail.com",
"firstName": "Jane",
"gender": "MALE",
"isLead": true,
"lang": "DEU",
"lastName": "Smith",
"phone": "(1) 212 555-1234",
"type": "ADULT"
}
}
],
"partnerId": "string",
"resellerBookingRef": "4AC773C0FF244aE"
},
"meta": {
"reqId": "5fd78809-4700-46d7-8386-3b8738117f4d"
}
}'
Copy
Responses application/json
201

Create a booking

objectobject
booking15 fieldsobject

The booking

metaobject

Request meta data

reqIduuid

Request ID

400

Create a booking

401

Create a booking

409

Create a booking

413

Create a booking

Response
{
"booking": {
"barcode": {
"format": "CODE128",
"value": "string"
},
"cancelable": true,
"channelId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"customer": {
"email": "customer@gmail.com",
"firstName": "string",
"lastName": "string",
"phone": "(1) 212 555-1234"
},
"ext": {
"string": "string"
},
"holdExt": {
"string": "string"
},
"holdId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"items": [
{
"availabilityId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"ext": {
"string": "string"
},
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"priceId": "string",
"productId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"quantity": 1,
"rate": {
"cancelable": true,
"code": "string",
"cutoff": 1,
Copy

Cancel a booking

Cancels a booking.

Auth
Headers
X-Request-IDstring

Request ID for request tracking.

Path Params
booking_idstring
PUT /bookings/cancel/{booking_id}
curl --request PUT \
--url 'https://channel.redeam.io/v1.2/bookings/cancel/{booking_id}' \
--header 'X-Request-ID: {X-Request-ID}' \
--header 'X-API-Key: {X-API-Key}' \
--header 'X-API-Secret: {X-API-Secret}'
Copy
Responses application/json
200

Cancel a booking

No response body
204

Cancel a booking

400

Cancel a booking

401

Cancel a booking

404

Cancel a booking

Response
No response
Copy

Retrieve a single booking

Returns a booking.

Auth
Headers
X-Request-IDstring

Request ID for request tracking.

Path Params
booking_idstring
GET /bookings/{booking_id}
curl --get \
--url 'https://channel.redeam.io/v1.2/bookings/{booking_id}' \
--header 'X-Request-ID: {X-Request-ID}' \
--header 'X-API-Key: {X-API-Key}' \
--header 'X-API-Secret: {X-API-Secret}'
Copy
Responses application/json
200

Retrieve a single booking

objectobject
booking15 fieldsobject

The booking

metaobject

Request meta data

reqIduuid

Request ID

401

Retrieve a single booking

404

Retrieve a single booking

Response
{
"booking": {
"barcode": {
"format": "CODE128",
"value": "string"
},
"cancelable": true,
"channelId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"customer": {
"email": "customer@gmail.com",
"firstName": "string",
"lastName": "string",
"phone": "(1) 212 555-1234"
},
"ext": {
"string": "string"
},
"holdExt": {
"string": "string"
},
"holdId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"items": [
{
"availabilityId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"ext": {
"string": "string"
},
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"priceId": "string",
"productId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"quantity": 1,
"rate": {
"cancelable": true,
"code": "string",
"cutoff": 1,
Copy

Acquire a hold

Acquires a hold.

Auth
Headers
X-Request-IDstring

Request ID for request tracking.

Request Body
objectobject
hold8 fieldsobject
metaobject

Request meta data

reqIduuid

Request ID

POST /holds
curl --request POST \
--url 'https://channel.redeam.io/v1.2/holds' \
--header 'X-Request-ID: {X-Request-ID}' \
--header 'X-API-Key: {X-API-Key}' \
--header 'X-API-Secret: {X-API-Secret}' \
--data '{
"hold": {
"expires": "2018-10-19T17:37:31-06:00",
"ext": {
"string": "string"
},
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"items": [
{
"at": "2018-10-19T17:37:31-06:00",
"availabilityId": "string",
"ext": {
"string": "string"
},
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"priceId": "string",
"productId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"quantity": 1,
"rateId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"supplierId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"travelerType": "ANY"
}
],
"partnerId": "string"
},
"meta": {
"reqId": "5fd78809-4700-46d7-8386-3b8738117f4d"
}
}'
Copy
Responses application/json
201

Acquire a hold

objectobject
hold8 fieldsobject
metaobject

Request meta data

reqIduuid

Request ID

400

Acquire a hold

401

Acquire a hold

409

Acquire a hold

413

Acquire a hold

Response
{
"hold": {
"expires": "2018-10-19T17:37:31-06:00",
"ext": {
"string": "string"
},
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"items": [
{
"at": "2018-10-19T17:37:31-06:00",
"availabilityId": "string",
"ext": {
"string": "string"
},
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"priceId": "string",
"productId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"quantity": 1,
"rate": {
"cancelable": true,
"code": "string",
"cutoff": 1,
"ext": {
"string": "string"
},
"holdable": true,
"holdablePeriod": 1,
"hours": [
{
"dates": [
"2018-10-19T17:37:31-06:00"
],
"daysOfWeek": [
0
],
"times": [
{
"close": 1020,
"open": "08:00"
}
],
"timezone": "America/New_York",
"valid": {
"from": "2018-10-19T17:37:31-06:00",
"until": "2018-10-19T17:37:31-06:00"
}
}
],
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"maxTravelers": 1,
"minTravelers": 1,
"name": "string",
"optionId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"partnerId": "string",
"prices": [
{
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"includedTaxes": [
{
"currency": "USD",
"id": "1",
"name": "tourism tax",
"net": 100,
"retail": 100
}
],
"labels": [
"string"
],
"name": "Adult",
"net": {
"amount": 1,
"currency": "USD"
},
"original": {
"amount": 1,
"currency": "USD"
},
"retail": {
"amount": 1,
"currency": "USD"
},
"status": "ACTIVE",
"travelerType": {
"ageBand": "ADULT",
"maxAge": 99,
"minAge": 18,
"modifier": "EU_CITIZEN",
"name": "Adult"
}
}
],
"productId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"refundable": true,
"title": "string",
"type": "FREESALE",
"valid": {
"from": "2018-10-19T17:37:31-06:00",
"until": "2018-10-19T17:37:31-06:00"
},
"version": 1
},
"rateId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"supplierId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"travelerType": "ANY"
}
],
"partnerId": "string",
"retrieved": "2018-10-19T17:37:31-06:00",
"status": "ACTIVE",
"timeline": [
{
"timestamp": "2018-10-19T17:37:31-06:00",
"typeOf": "CANCELLED"
}
]
},
"meta": {
"reqId": "5fd78809-4700-46d7-8386-3b8738117f4d"
}
}
Copy

Release a hold

Releases a hold.

Auth
Headers
X-Request-IDstring

Request ID for request tracking.

Path Params
hold_idstring
DELETE /holds/{hold_id}
curl --request DELETE \
--url 'https://channel.redeam.io/v1.2/holds/{hold_id}' \
--header 'X-Request-ID: {X-Request-ID}' \
--header 'X-API-Key: {X-API-Key}' \
--header 'X-API-Secret: {X-API-Secret}'
Copy
Responses application/json
204

Release a hold

No response body
401

Release a hold

404

Release a hold

Response
No response
Copy

Retrieve a hold

Returns a hold.

Auth
Headers
X-Request-IDstring

Request ID for request tracking.

Path Params
hold_idstring
GET /holds/{hold_id}
curl --get \
--url 'https://channel.redeam.io/v1.2/holds/{hold_id}' \
--header 'X-Request-ID: {X-Request-ID}' \
--header 'X-API-Key: {X-API-Key}' \
--header 'X-API-Secret: {X-API-Secret}'
Copy
Responses application/json
200

Retrieve a hold

objectobject
hold8 fieldsobject
metaobject

Request meta data

reqIduuid

Request ID

401

Retrieve a hold

404

Retrieve a hold

Response
{
"hold": {
"expires": "2018-10-19T17:37:31-06:00",
"ext": {
"string": "string"
},
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"items": [
{
"at": "2018-10-19T17:37:31-06:00",
"availabilityId": "string",
"ext": {
"string": "string"
},
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"priceId": "string",
"productId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"quantity": 1,
"rate": {
"cancelable": true,
"code": "string",
"cutoff": 1,
"ext": {
"string": "string"
},
"holdable": true,
"holdablePeriod": 1,
"hours": [
{
"dates": [
"2018-10-19T17:37:31-06:00"
],
"daysOfWeek": [
0
],
"times": [
{
"close": 1020,
"open": "08:00"
}
],
"timezone": "America/New_York",
"valid": {
"from": "2018-10-19T17:37:31-06:00",
"until": "2018-10-19T17:37:31-06:00"
}
}
],
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"maxTravelers": 1,
"minTravelers": 1,
"name": "string",
"optionId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"partnerId": "string",
"prices": [
{
"id": "5fd78809-4700-46d7-8386-3b8738117f4d",
"includedTaxes": [
{
"currency": "USD",
"id": "1",
"name": "tourism tax",
"net": 100,
"retail": 100
}
],
"labels": [
"string"
],
"name": "Adult",
"net": {
"amount": 1,
"currency": "USD"
},
"original": {
"amount": 1,
"currency": "USD"
},
"retail": {
"amount": 1,
"currency": "USD"
},
"status": "ACTIVE",
"travelerType": {
"ageBand": "ADULT",
"maxAge": 99,
"minAge": 18,
"modifier": "EU_CITIZEN",
"name": "Adult"
}
}
],
"productId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"refundable": true,
"title": "string",
"type": "FREESALE",
"valid": {
"from": "2018-10-19T17:37:31-06:00",
"until": "2018-10-19T17:37:31-06:00"
},
"version": 1
},
"rateId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"supplierId": "5fd78809-4700-46d7-8386-3b8738117f4d",
"travelerType": "ANY"
}
],
"partnerId": "string",
"retrieved": "2018-10-19T17:37:31-06:00",
"status": "ACTIVE",
"timeline": [
{
"timestamp": "2018-10-19T17:37:31-06:00",
"typeOf": "CANCELLED"
}
]
},
"meta": {
"reqId": "5fd78809-4700-46d7-8386-3b8738117f4d"
}
}
Copy