{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/api/catalog/activities/duration-and-validity/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Duration and validity

\n

Both the /activities endpoint and /activities/{activityUuid} endpoints include the length of an activity. There are multiple properties which can describe how long an activity lasts. Depending on the activity you will choose between its duration or validity.

\n

Format

\n

Values for both duration and validity are presented in the ISO 8601 standard. The example below represents a length of \"1 day and 12 hours\":

\n
\n
\n
Copy
\n
Copied
\n
\n 
P1DT12H
\n
\n

Some activity providers are very precise about the units used for describing an activity's length. Please avoid converting time periods to a different unit. For example, a value of PT24H should be displayed as \"24 hours\" and not \"1 day\".

\n

Duration

\n

Duration is more appropriate for tours and other activities that follow a schedule, usually with a specific start and end. When duration is set for an activity, you will see the duration_range property.

\n

Duration may be a single period of time. In the example response below we can say the activity lasts 2 hours:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n\t[...]\n\t\"duration_range\": {\n\t\t\"min\": \"PT2H\",\n\t\t\"max\": \"PT2H\"\n\t},\n\t[...]\n}
\n
\n

Duration can also be a time range. In the example response below, the activity lasts 1-2 hours:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n\t[...]\n\t\"duration_range\": {\n\t\t\"min\": \"PT1H\",\n\t\t\"max\": \"PT2H\"\n\t},\n\t[...]\n}
\n
\n

The min and max properties for duration_range correspond to the duration's lower and upper bounds respectively. Both properties are optional and it's possible to find activities with only one of these properties.

\n

In the example response below, the activity does not have a minimum duration. We can say that it lasts up to 8 hours:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n\t[...]\n\t\"duration_range\": {\n\t\t\"max\": \"PT8H\"\n\t},\n\t[...]\n}
\n
\n

Alternatively, in the example response below, the activity does not have a maximum duration. We can say that it lasts at least 2 hours:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n\t[...]\n\t\"duration_range\": {\n\t\t\"min\": \"PT2H\"\n\t},\n\t[...]\n}
\n
\n

Sometimes an activity's duration is dependant on other factors, such as weather or the option booked at checkout, and cannot be well-defined. When either max or min has a value of P0D, we say the duration is flexible:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n\t[...]\n\t\"duration_range\": {\n\t\t\"max\": \"P0D\"\n\t},\n\t[...]\n}
\n
\n

When the duration_range property is absent, use the validity property to describe an activity's length instead.

\n

Validity

\n

Validity is more appropriate for activities without a planned schedule, such as a city pass or museum entrance.

\n

The validity property represents the maximum period of time the activity is valid for a customer once they start.

\n

In the example response below, the activity is valid for 24 hours:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n\t[...]\n\t\"validity\": \"PT24H\",\n\t[...]\n}
\n
\n

When the validity property contains a value of P0D, the activity does not have a well-defined length of time. On musement.com, we define the length for these activities as \"flexible\".

","headings":[{"value":"Duration and validity","depth":1},{"value":"Format","depth":2},{"value":"Duration","depth":2},{"value":"Validity","depth":2}]},"contentItem":{"data":{"lastModified":"2025-12-18T16:31:42.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"3fb01d31-3c1d-55b0-b586-db92fc661a15__redocly content/api/catalog/activities/duration-and-validity/","seo":{"title":"Duration and validity","description":"The length of a customer's experience depends on an activity's duration or validity in the Musement API.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api/catalog/activities/duration-and-validity.md","pageBaseUrl":"/api/catalog/activities/duration-and-validity","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Duration and validity","id":"duration-and-validity"},{"depth":2,"value":"Format","id":"format"},{"depth":2,"value":"Duration","id":"duration"},{"depth":2,"value":"Validity","id":"validity"}]},"data":{"title":"","redirectFrom":["/guide/activities/duration-and-validity/","/api/partner/catalog/activities/duration-and-validity/"],"seo":{"description":"The length of a customer's experience depends on an activity's duration or validity in the Musement API."}},"catalogInfo":null,"link":"/api/catalog/activities/duration-and-validity/","sidebarName":"__alternative-sidebar__-data-24763-api-sidebars.yaml","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}