find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/hotelumo-com:hotelumo-com-availability-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Hotelumo Availability API
  version: 1.0.0
  description: 'Public REST API for Hotelumo. Authenticate with an API key created in the Hotelumo dashboard: send the base64-encoded key secret with HTTP Basic auth. Each key carries per-resource scopes like `reservations:read` or `rates:write`.'
servers:
- url: https://api.hotelumo.com
tags:
- name: Availability
paths:
  /api/hotels/{hotelId}/availability:
    get:
      tags:
      - Availability
      summary: Find public room offers for a stay
      description: Returns sanitized room-type offers for the requested dates and occupancy. Prices and inventory are calculated by the server.
      security:
      - apiKey: []
      - {}
      parameters:
      - in: path
        name: hotelId
        required: true
        schema:
          type: string
      - in: query
        name: checkInDate
        required: true
        schema:
          type: string
          format: date
      - in: query
        name: checkOutDate
        required: true
        schema:
          type: string
          format: date
      - in: query
        name: adults
        schema:
          type: integer
          default: 2
      - in: query
        name: children
        schema:
          type: integer
          default: 0
      - in: query
        name: infants
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Public room offers
        '400':
          description: Invalid dates or occupancy
        '404':
          description: Hotel not found
      operationId: getApiHotelsHotelIdAvailability
      x-codeSamples:
      - lang: Node + Request
        source: "const request = require('request');\n\nconst options = {\n  method: 'GET',\n  url: 'https://api.hotelumo.com/api/hotels/%7BhotelId%7D/availability',\n  qs: {\n    checkInDate: 'SOME_STRING_VALUE',\n    checkOutDate: 'SOME_STRING_VALUE',\n    adults: 'SOME_INTEGER_VALUE',\n    children: 'SOME_INTEGER_VALUE',\n    infants: 'SOME_INTEGER_VALUE'\n  },\n  headers: {Authorization: 'Basic REPLACE_BASIC_AUTH'}\n};\n\nrequest(options, function (error, response, body) {\n  if (error) throw new Error(error);\n\n  console.log(body);\n});\n"
      - lang: Shell + Curl
        source: "curl --request GET \\\n  --url 'https://api.hotelumo.com/api/hotels/%7BhotelId%7D/availability?checkInDate=SOME_STRING_VALUE&checkOutDate=SOME_STRING_VALUE&adults=SOME_INTEGER_VALUE&children=SOME_INTEGER_VALUE&infants=SOME_INTEGER_VALUE' \\\n  --header 'Authorization: Basic REPLACE_BASIC_AUTH'"
      - lang: Shell + Httpie
        source: "http GET 'https://api.hotelumo.com/api/hotels/%7BhotelId%7D/availability?checkInDate=SOME_STRING_VALUE&checkOutDate=SOME_STRING_VALUE&adults=SOME_INTEGER_VALUE&children=SOME_INTEGER_VALUE&infants=SOME_INTEGER_VALUE' \\\n  Authorization:'Basic REPLACE_BASIC_AUTH'"
      - lang: Python + Python3
        source: 'import http.client


          conn = http.client.HTTPSConnection("api.hotelumo.com")


          headers = { ''Authorization'': "Basic REPLACE_BASIC_AUTH" }


          conn.request("GET", "/api/hotels/%7BhotelId%7D/availability?checkInDate=SOME_STRING_VALUE&checkOutDate=SOME_STRING_VALUE&adults=SOME_INTEGER_VALUE&children=SOME_INTEGER_VALUE&infants=SOME_INTEGER_VALUE", headers=headers)


          res = conn.getresponse()

          data = res.read()


          print(data.decode("utf-8"))'
      - lang: Php + Curl
        source: "<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, [\n  CURLOPT_URL => \"https://api.hotelumo.com/api/hotels/%7BhotelId%7D/availability?checkInDate=SOME_STRING_VALUE&checkOutDate=SOME_STRING_VALUE&adults=SOME_INTEGER_VALUE&children=SOME_INTEGER_VALUE&infants=SOME_INTEGER_VALUE\",\n  CURLOPT_RETURNTRANSFER => true,\n  CURLOPT_ENCODING => \"\",\n  CURLOPT_MAXREDIRS => 10,\n  CURLOPT_TIMEOUT => 30,\n  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n  CURLOPT_CUSTOMREQUEST => \"GET\",\n  CURLOPT_HTTPHEADER => [\n    \"Authorization: Basic REPLACE_BASIC_AUTH\"\n  ],\n]);\n\n$response = curl_exec($curl);\n$err = curl_error($curl);\n\ncurl_close($curl);\n\nif ($err) {\n  echo \"cURL Error #:\" . $err;\n} else {\n  echo $response;\n}"
      - lang: Php + Http1
        source: "<?php\n\n$request = new HttpRequest();\n$request->setUrl('https://api.hotelumo.com/api/hotels/%7BhotelId%7D/availability');\n$request->setMethod(HTTP_METH_GET);\n\n$request->setQueryData([\n  'checkInDate' => 'SOME_STRING_VALUE',\n  'checkOutDate' => 'SOME_STRING_VALUE',\n  'adults' => 'SOME_INTEGER_VALUE',\n  'children' => 'SOME_INTEGER_VALUE',\n  'infants' => 'SOME_INTEGER_VALUE'\n]);\n\n$request->setHeaders([\n  'Authorization' => 'Basic REPLACE_BASIC_AUTH'\n]);\n\ntry {\n  $response = $request->send();\n\n  echo $response->getBody();\n} catch (HttpException $ex) {\n  echo $ex;\n}"
      - lang: Php + Http2
        source: "<?php\n\n$client = new http\\Client;\n$request = new http\\Client\\Request;\n\n$request->setRequestUrl('https://api.hotelumo.com/api/hotels/%7BhotelId%7D/availability');\n$request->setRequestMethod('GET');\n$request->setQuery(new http\\QueryString([\n  'checkInDate' => 'SOME_STRING_VALUE',\n  'checkOutDate' => 'SOME_STRING_VALUE',\n  'adults' => 'SOME_INTEGER_VALUE',\n  'children' => 'SOME_INTEGER_VALUE',\n  'infants' => 'SOME_INTEGER_VALUE'\n]));\n\n$request->setHeaders([\n  'Authorization' => 'Basic REPLACE_BASIC_AUTH'\n]);\n\n$client->enqueue($request)->send();\n$response = $client->getResponse();\n\necho $response->getBody();"
  /api/hotels/{hotelId}/book-reservation:
    post:
      tags:
      - Availability
      summary: Request a room reservation
      description: Revalidates the selected offer, then creates a REQUESTED reservation with one unassigned PENDING room for hotel staff to approve.
      security:
      - apiKey: []
      - {}
      responses:
        '201':
          description: Reservation request created
        '409':
          description: The selected offer is no longer available
      operationId: postApiHotelsHotelIdBookReservation
      x-codeSamples:
      - lang: Node + Request
        source: "const request = require('request');\n\nconst options = {\n  method: 'POST',\n  url: 'https://api.hotelumo.com/api/hotels/%7BhotelId%7D/book-reservation',\n  headers: {Authorization: 'Basic REPLACE_BASIC_AUTH'}\n};\n\nrequest(options, function (error, response, body) {\n  if (error) throw new Error(error);\n\n  console.log(body);\n});\n"
      - lang: Shell + Curl
        source: "curl --request POST \\\n  --url https://api.hotelumo.com/api/hotels/%7BhotelId%7D/book-reservation \\\n  --header 'Authorization: Basic REPLACE_BASIC_AUTH'"
      - lang: Shell + Httpie
        source: "http POST https://api.hotelumo.com/api/hotels/%7BhotelId%7D/book-reservation \\\n  Authorization:'Basic REPLACE_BASIC_AUTH'"
      - lang: Python + Python3
        source: 'import http.client


          conn = http.client.HTTPSConnection("api.hotelumo.com")


          headers = { ''Authorization'': "Basic REPLACE_BASIC_AUTH" }


          conn.request("POST", "/api/hotels/%7BhotelId%7D/book-reservation", headers=headers)


          res = conn.getresponse()

          data = res.read()


          print(data.decode("utf-8"))'
      - lang: Php + Curl
        source: "<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, [\n  CURLOPT_URL => \"https://api.hotelumo.com/api/hotels/%7BhotelId%7D/book-reservation\",\n  CURLOPT_RETURNTRANSFER => true,\n  CURLOPT_ENCODING => \"\",\n  CURLOPT_MAXREDIRS => 10,\n  CURLOPT_TIMEOUT => 30,\n  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n  CURLOPT_CUSTOMREQUEST => \"POST\",\n  CURLOPT_HTTPHEADER => [\n    \"Authorization: Basic REPLACE_BASIC_AUTH\"\n  ],\n]);\n\n$response = curl_exec($curl);\n$err = curl_error($curl);\n\ncurl_close($curl);\n\nif ($err) {\n  echo \"cURL Error #:\" . $err;\n} else {\n  echo $response;\n}"
      - lang: Php + Http1
        source: "<?php\n\n$request = new HttpRequest();\n$request->setUrl('https://api.hotelumo.com/api/hotels/%7BhotelId%7D/book-reservation');\n$request->setMethod(HTTP_METH_POST);\n\n$request->setHeaders([\n  'Authorization' => 'Basic REPLACE_BASIC_AUTH'\n]);\n\ntry {\n  $response = $request->send();\n\n  echo $response->getBody();\n} catch (HttpException $ex) {\n  echo $ex;\n}"
      - lang: Php + Http2
        source: "<?php\n\n$client = new http\\Client;\n$request = new http\\Client\\Request;\n\n$request->setRequestUrl('https://api.hotelumo.com/api/hotels/%7BhotelId%7D/book-reservation');\n$request->setRequestMethod('POST');\n$request->setHeaders([\n  'Authorization' => 'Basic REPLACE_BASIC_AUTH'\n]);\n\n$client->enqueue($request)->send();\n$response = $client->getResponse();\n\necho $response->getBody();"
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: basic
      description: 'HTTP Basic auth carrying only the API key secret: `Authorization: Basic base64(<key secret>)`.'
    accessToken:
      type: apiKey
      in: header
      name: Authorization
      description: 'Operator session token issued by the Hotelumo dashboard: `Authorization: Token <access token>`.'