Documentation

Portfolio

This endpoint provides a cached list of activities available in a specific destination. Each item includes the activity code, name, available modalities, pax range, supplier, and other essential data. It is ideal for partners looking to sync or cache activity data by destination

Endpoint

GET https://api.test.hotelbeds.com/activity-cache-api/1.0/portfolio?destination={{DESTINATION}}&offset={{OFFSET}}&limit={{LIMIT}}

Query Parameters

Parameter Type Required Description
destination string Yes Destination code (e.g., "PMI", "BCN") to filter activities.
offset int Yes Index of the first result to return (used for pagination).
limit int Yes Maximum number of results to return.


Response

Status Code: 200 OK

Response Fields (per activity):

Each one contains:

  • code: – Activity identifier.
  • name: – Name of the activity.
  • type: - It will always be "TICKET" .
  • country: - Country indentifier assigned to the activity.
  • destination: - Destinatiton identtifer assigned to the activity.

Modality each one contains:

  • code: string – Modality identifier.
  • name: string – Description of the modality.
  • onSale: boolean – Indicates if it is currently available for sale.
  • rates: array – Pricing categories (e.g., "STANDARD").
  • languages: array – Supported languages (e.g., "ENG", "CAS").
  • sessions: array – Available start times slots (e.g., "12:00").

  • paxRange: - Min and max passangers accepted per service.
  • suppliers: - Supplier identifier, include the internal code of reference and the commerical name.

Example Response:

[

{

"code": "E-E10-000020010",

"name": "Surf Lounge Ibiza",

"type": "TICKET",

"country": "ES",

"destination": "BCN",

"modalities": [

{

"code": "1",

"name": "VIP riders - 30 pax 1 hour",

"onSale": true,

"rates": ["STANDARD"],

"languages": [],

"sessions": []

}

],

"paxRange": { "min": 1, "max": 99 },

"suppliers": [

{

"code": "0000195226",

"name": "ROLDAN SERVICIO DE TRANS. ESPEC. SL"

}

]

}