Experience Search and availability

In order to book experiences, you need to go through 4 steps:

• Search for experience
• Get experience details (optional)
• Book the experience
• Retrieve booking details

Experience Search

Search for experiences, activities, transfers, and programs based on various criteria including location, dates, and traveler requirements.

Endpoint: POST /api/v1/experiences/liste

Parameters:

• locale (query, optional): 2-letter language code (e.g., en, fr)

Request Body:

{
  "search": "Paris",
  "cities": ["city-id-1", "city-id-2"],
  "countries": ["country-id-1"],
  "regions": ["region-id-1"],
  "types": ["Activity", "Transfer", "Program"],
  "startingPoint": "paris-center",
  "endingPoint": "versailles",
  "themes": ["cultural", "historical"],
  "segments": ["luxury", "family"],
  "duration": 4,
  "organizationId": "org-123",
  "toOrganizationId": "to-org-456",
  "experienceComposition": {
    "adults": 2,
    "children": 1,
    "childrenBirthdates": ["2010-05-15"]
  },
  "startAt": "2024-06-15",
  "endAt": "2024-06-20",
  "searchMinPrice": true,
  "maxPax": 4,
  "minPax": 2,
  "priceRange": [100, 500],
  "departureLocation": "paris-1",
  "returnLocation": "paris-1",
  "guided": true,
  "minDuration": 2,
  "maxDuration": 8,
  "experiencePricingType": "fit",
  "excludedExperiences": ["exp-789"],
  "sort": "price.asc"
}

Response:

[
  {
    "id": "exp-123",
    "name": "Louvre Museum Private Tour",
    "tags": ["cultural", "art", "museum"],
    "experienceType": "Activity",
    "inCity": {
      "id": "paris-1",
      "title": "Paris"
    },
    "startPosition": {
      "id": "pos-1",
      "name": "Louvre Entrance",
      "address": "Rue de Rivoli, Paris"
    },
    "endPosition": {
      "id": "pos-2",
      "name": "Louvre Pyramid",
      "address": "Louvre Museum, Paris"
    },
    "durationDays": 0,
    "durationHours": 3,
    "durationMinutes": 0,
    "isExtra": false,
    "isRepeatable": false,
    "showcased": true,
    "connectionRequestId": "conn-456",
    "organizationId": "org-123",
    "organizationName": "Paris Culture Tours",
    "organizationImages": "https://example.com/org-logo.jpg",
    "imageUrl": "https://example.com/louvre-tour.jpg",
    "price": {
      "amount": 150.00,
      "currency": "EUR",
      "perPerson": true
    },
    "cancellationPolicies": "Free cancellation up to 24 hours before",
    "summary": "Discover the world's most famous artworks with an expert guide",
    "pricingType": "fit",
    "lastBookingDate": "2024-05-30T10:00:00Z",
    "totalBookingsCount": 45,
    "translations": "Available in English, French, Spanish"
  }
]

Experience Details

Get Experience Information

Retrieve detailed information about a specific experience.

Endpoint: GET /api/v1/experiences/{experienceId}

Parameters:

• experienceId (path, required): Experience ID
• locale (query, optional): 2-letter language code (e.g., en, fr)

Response:

{
  "id": "exp-123",
  "dmcReference": "DMC-LVR-001",
  "name": "Louvre Museum Private Tour",
  "isReservableAlone": true,
  "isRepeatable": "false",
  "state": "available",
  "description": "Immerse yourself in the world's largest art museum with a private expert guide...",
  "inCity": {
    "id": "paris-1",
    "title": "Paris",
    "country": {
      "id": "fr",
      "title": "France"
    }
  },
  "startPosition": {
    "id": "pos-1",
    "name": "Louvre Main Entrance",
    "address": "Rue de Rivoli, 75001 Paris",
    "lat": 48.8606,
    "lon": 2.3376
  },
  "endPosition": {
    "id": "pos-2",
    "name": "Louvre Pyramid",
    "address": "Louvre Pyramid, 75001 Paris",
    "lat": 48.8606,
    "lon": 2.3376
  },
  "locationsExtraInformations": "Meet at the glass pyramid entrance",
  "distance": 2.5,
  "distanceUnit": "km",
  "durationDays": "0",
  "durationHours": "3",
  "durationMinutes": "0",
  "currency": "EUR",
  "extraRemarks": "Comfortable walking shoes recommended",
  "pictures": [
    {
      "id": "pic-1",
      "displayName": "Louvre Exterior",
      "imageUrl": "https://example.com/louvre-1.jpg",
      "isMainPicture": true,
      "isDayPicture": false
    }
  ],
  "sustainableLevel": 3,
  "includedServices": "Professional guide, skip-the-line tickets, audio equipment",
  "excludedServices": "Transportation, meals, gratuities",
  "type": "Activity",
  "organizationId": "org-123",
  "organizationName": "Paris Culture Tours",
  "periods": [
    {
      "id": "period-1",
      "startAt": "2024-01-01",
      "endAt": "2024-12-31",
      "availableDays": [1, 2, 3, 4, 5, 6],
      "periodType": "free_sale",
      "state": "free_sale",
      "price": 150.00,
      "perPax": true,
      "roomSupplement": 0,
      "hasRoomSupplement": false,
      "minPax": 1,
      "minPaxForDeparture": "2",
      "currentPaxForDeparture": "0",
      "maxPax": 8,
      "allotments": "unlimited",
      "allotmentsUsed": "0",
      "breakEven": 2,
      "adultPax": [
        {
          "id": "adult-1",
          "price": 150.00,
          "paxRange": [1, 8]
        }
      ],
      "childrenPax": [
        {
          "id": "child-1",
          "price": 75.00,
          "ageRange": [6, 17]
        }
      ]
    }
  ],
  "mediaLinks": [
    {
      "id": "media-1",
      "title": "Virtual Tour Preview",
      "link": "https://example.com/virtual-tour"
    }
  ],
  "accreditations": [
    {
      "id": "acc-1",
      "displayName": "Certified Tour Guide"
    }
  ],
  "sustainableClusters": [
    {
      "id": "sust-1",
      "displayName": "Eco-Friendly Tourism",
      "description": "Supporting sustainable tourism practices"
    }
  ],
  "activity": {
    "pickUpPoint": "Hotel lobby",
    "dropOffPoint": "Louvre Museum",
    "pickUpPointTime": "09:00",
    "dropOffPointTime": "12:00",
    "freeVisitInformations": "2 hours free time at the museum",
    "isExtra": false
  },
  "hasToRequest": false,
  "extras": [
    {
      "id": "extra-1",
      "name": "Audio Guide Upgrade",
      "cancellationPolicies": "Non-refundable",
      "recommendations": [
        {
          "id": "rec-1",
          "name": "Seine River Cruise",
          "inCity": {
            "title": "Paris"
          }
        }
      ],
      "required": [],
      "suggested": []
    }
  ],
  "highlights": "Mona Lisa, Venus de Milo, Winged Victory of Samothrace",
  "cancellationPolicies": "Free cancellation up to 24 hours before the tour",
  "guiding": true,
  "guidingLanguages": ["English", "French", "Spanish"],
  "difficulty": "Easy",
  "pricingType": "fit",
  "segments": [
    {
      "id": "seg-1",
      "displayName": "Cultural"
    }
  ],
  "themes": [
    {
      "id": "theme-1",
      "displayName": "Art & Museums"
    }
  ],
  "bestMatches": [
    {
      "id": "match-1",
      "name": "Orsay Museum Tour",
      "inCity": {
        "title": "Paris"
      }
    }
  ],
  "summary": "Discover the world's most famous artworks with an expert guide",
  "incompatibilities": [],
  "organizationBookingReceptionEmail": "bookings@parisculture.com"
}