This operation returns the details and price of an activity with a reduced contents structure (lighter).
Below an example of how to structure the call:
{
"code": "E-E10-PF2SHOW",
"from": "2022-03-29",
"to": "2022-03-30",
"language": "en",
"paxes": [
{"age": 30},
{"age": 30}
]
}The example above contains a service code, a date range (date from and date to) a language in which the descriptions will be returned and a list of paxes with their ages.
Specifications:
POST https://api.test.hotelbeds.com/activity-api/3.0/activities/details
|
NAME |
DESCRIPTION |
Mandatory |
|
code |
Activity code. |
Yes |
|
From |
Return activities available dates and prices from the specified date (format: YYYY-MM-DD) |
Yes |
|
To |
Return activities available dates and prices up to the specified date (format: YYYY-MM-DD) |
Yes |
|
Language |
Language code in which multi-language texts will be returned. (see here for static list of language codes or use the Contents API to retrieve them). If no language is provided, the results will be returned in the language previously used to authenticate credentials (see authentication procedure). |
No |
|
Paxes |
List of passengers details . |
Yes (at least ages) Example for two adult paxes: "paxes": [ {"age": 30}, {"age": 30} ] |
This operation returns the details and price of an activity including the full contents factsheet.
The following is an example on how to structure the call:
{
"code": "E-E10-PF2SHOW",
"from": "2022-03-29",
"to": "2022-03-30",
"language": "en",
"paxes": [
{"age": 30},
{"age": 30}
]
}POST https://api.test.hotelbeds.com/activity-api/3.0/activities/details/full
|
NAME |
DESCRIPTION |
Mandatory |
|
code |
Activity code. |
Yes |
|
From |
Return activities available dates and prices from the specified date (format: YYYY-MM-DD) |
Yes |
|
To |
Return activities available dates and prices up to the specified date (format: YYYY-MM-DD) |
Yes |
|
Language |
Language code in which multi-language texts will be returned. (see here for static list of language codes or use the Contents API to retrieve them). If no language is provided, the results will be returned in the language previously used to authenticate credentials (see authentication procedure). |
No |
|
Paxes |
List of passengers details . |
Yes (at least ages) Example for two adult paxes: "paxes": [ {"age": 30}, {"age": 30} ] |
In addition to it, there is also the capability to obtain the detailed content for a particular service and modality. The only requirement is to specify this in the request as detailed below:
{
"code": "E-E10-TABLAO3SHO",
"modalityCode": "COPA_SHOW",
"from": "2022-05-28",
"to": "2022-05-30",
"language": "en",
"paxes": [
{"age": 30},
{"age": 8}
]
}From a business perspective the activity or service is configured with the following structure:
The detail API call groups the rates, sessions, languages and dates available with the same price for a modality and Activity and clearly define the combinations with a rateKey. All the rateKeys are valid during 30 minutes in APITUDE Activities, rateKeys cannot be also used more that once to confirm, you need to generate a unique ratekey for booking.
Having the rateKey temporarily stored helps you to only make the reference to it in the confirmation operation and the confirmation is pretty simple (check on the confirmation operation)
Consider the following fragment of the response from the detail call (in this example is for two adults):
{
"operationId": "opct9bd9d",
"auditData": {... },
"activity": {
"amountsFrom": [...],
"operationDays": [...],
"modalities": [{
"duration": {... },
"destinationCode": "BCN",
"minChildrenAge": 2,
"maxChildrenAge": 12,
"amountsFrom": [...],
"amountUnitType": "PAX",
"rates": [{
"rateCode": "GENERIC",
"rateDetails": [{
"rateKey": "4qnr135lvuucjm653fb50aj352",
"operationDates": [{
"from": "2016-03-29",
"to": "2016-03-29",
"cancellationPolicies": [...]
}, {
"from": "2016-03-30",
"to": "2016-03-30",
"cancellationPolicies": [...]
}],
"sessions": [{
"code": "MORNING",
"name": "Morning session at 10:00AM"
}, {
"code": "EVENING",
"name": "Evening session at 8:00PM"
}],
"languages": [{
"code": "es",
"name": "Spanish"
}, {
"code": "en",
"name": "English"
}]
"minimumDuration": {... },
"maximumDuration": {... },
"paxAmounts": [{
"paxType": "CHILD",
"ageFrom": 2,
"ageTo": 12,
"amount": 15,
"boxOfficeAmount": 15
}, {
"paxType": "ADULT",
"ageFrom": 13,
"ageTo": 999,
"amount": 65,
"boxOfficeAmount": 65
}],
"agencyCommission": {... },
"totalAmount": {
"amount": 130,
"boxOfficeAmount": 130
}
}]
}],
"supplierInformation": {... },
"providerInformation": {... },
"comments": [...],
"code": "DALIMENU",
"name": "Dalí menu and show"
}]
"code": "E-E10-PF2SHOW",
"type": "TICKET",
"name": "Tablao Palacio de Flamenco - Show 2",
"currency": "EUR"
}
}