{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"About Status API","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"about-status-api","__idx":0},"children":["About Status API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Learn how the Status API helps you monitor the operational health of Demand API endpoints and automate responses to service degradation."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Status API provides the current operational status of monitored Demand API endpoint groups and individual endpoints."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the Status API to detect service degradation and automatically adapt your integration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For example, you can temporarily disable affected functionality, retry requests with backoff, or fail over to alternative workflows while an incident is in progress."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Unlike relying on failed requests to detect service issues, the Status API lets your application check the operational status of Demand API endpoints before sending requests."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"benefits","__idx":2},"children":["Benefits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Integrating with the Status API enables you to:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✓ Detect service degradation before it significantly impacts your users.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✓ Reduce the mean time to detect (MTTD) operational incidents.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✓ Automatically enable failover or degraded operating modes.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✓ Avoid unnecessary retries against endpoints experiencing outages.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✓ Monitor the health of related endpoint groups instead of checking individual endpoints when appropriate.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"view-status-in-the-dashboard","__idx":3},"children":["View status in the dashboard"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://partnerships-status.booking.com/status"},"children":["Status dashboard"]}," to view the current operational status of monitored Demand API endpoints."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the Status API when your integration needs to retrieve status programmatically and respond to service degradation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-it-works","__idx":4},"children":["How it works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Status API continuously evaluates the health of selected Demand API endpoints."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you call the Status API, it returns the current operational status for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Endpoint groups, such as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reservations"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rates and availability."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The individual endpoints within each group."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each status is one of three values:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["up"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The endpoint is operating normally."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["minor_outage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The endpoint is reachable but experiencing degradation, such as elevated latency or partial errors."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["major_outage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The endpoint is experiencing a significant outage and requests are likely to fail."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If an endpoint or group is degraded, the response also includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When the issue began (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["since"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A human-readable reason describing the incident."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoint-groups","__idx":5},"children":["Endpoint groups"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Status API reports the health of monitored endpoints grouped by functional area. The dashboard currently monitors the following groups and stable Demand API versions."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Currently only available for accommodations."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Group"},"children":["Group"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API versions"},"children":["API versions"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rates and availability"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/accommodations/search"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#6B7280","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.1"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#0070C9","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.2"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#003B95","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.3"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/accommodations/availability"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#6B7280","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.1"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#0070C9","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.2"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#003B95","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.3"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/accommodations/bulk-availability"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#6B7280","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.1"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reservations"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/orders/details"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#6B7280","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.1"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#0070C9","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.2"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#003B95","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.3"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/orders/details/accommodations"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#6B7280","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.1"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#0070C9","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.2"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#003B95","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.3"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/orders/preview"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#6B7280","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.1"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#0070C9","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.2"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#003B95","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.3"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/orders/modify/preview"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#0070C9","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.2"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#003B95","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.3"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/orders/create"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#6B7280","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.1"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#0070C9","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.2"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#003B95","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.3"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/orders/cancel"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#6B7280","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.1"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#0070C9","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.2"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#003B95","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.3"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/orders/modify"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#6B7280","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.1"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#0070C9","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.2"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#003B95","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.3"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The status reported for a group reflects the most severe status of any monitored endpoint in that group."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example, if one endpoint has a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["major_outage"]},", the group status is also ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["major_outage"]},", even if the remaining endpoints are operational."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Current state only"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Status API reports the current operational state only. It does ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not provide"]}," historical availability data, incident history or uptime statistics."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":6},"children":["Next steps"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To start monitoring the operational status of Demand API endpoints, see:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/additional-services/status-api/integration-guide"},"children":["Integration guide"]}," for technical details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/additional-services/status-api/status-api-open-specs"},"children":["Status API specifications"]}," for schema and examples."]}]}]}]},"headings":[{"value":"About Status API","id":"about-status-api","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Benefits","id":"benefits","depth":2},{"value":"View status in the dashboard","id":"view-status-in-the-dashboard","depth":2},{"value":"How it works","id":"how-it-works","depth":2},{"value":"Endpoint groups","id":"endpoint-groups","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"About Status API"}},"lastModified":"2026-10-23T17:00:10.489Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/additional-services/status-api/about","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}