Public API v1

Add an accommodation option to a destination.

post/v1/trips/{id}/variants/{variantId}/destinations/{destinationKey}/options/accommodation

Request

  • Base URL: https://api.mynextadventure.cloud (the document declares no server; this is the origin it was published from)
  • URL: https://api.mynextadventure.cloud/v1/trips/{id}/variants/{variantId}/destinations/{destinationKey}/options/accommodation
  • Auth: API key in header X-API-Key

Path parameters

idstring required
variantIdstring required
destinationKeystring required

Request body

namestring required

Display name of the accommodation exactly as a human would call it (e.g. "Villa Ave"). Never embed price, town, dates, status or commentary here — those belong in totalCost, location, checkIn/checkOut and notes.

type'hotel' | 'hostel' | 'apartment' | 'house' | 'camping' | 'other' required

Type of accommodation.

totalCostnumber required

Total cost for the stay.

currencystring required

Currency code (e.g. "USD").

checkInstring date-time

Check-in date.

checkOutstring date-time

Check-out date.

checkInTimestring

Check-in time of day (e.g. "15:00").

checkOutTimestring

Check-out time of day (e.g. "11:00").

freeCancellationUntilstring date-time

Free cancellation deadline.

notesstring

Free-form commentary: provenance, caveats, "user has stayed here before", trade-offs. Anything without a dedicated field goes here, not in name.

sourceUrlstring
imageUrlstring

URL of a photo of the accommodation. Hotlinked, not copied.

descriptionstring

Short description of the accommodation.

urlstring

Link to the listing or the property website.

featuresstring[]

Facilities this accommodation offers.

Response

Option created.

keystring required

Server-assigned key for the newly-created option.

Changes

No recorded changes to this operation across all 1 revision of this API.