HTTP Status Codes

The Hospitable Public API returns HTTP Status Codes with every response, including error codes. All being well, you should expect to see status codes in the 200 range alongside your responses.

In the event of a problem, the status code is a reliable indicator of what went wrong. Return codes in the 400 range indicate that there was an issue with the request that was sent, and you may need to change the request, update the code, or data on your end.

Status codes in the 500 range may mean that either we or a provider (e.g. Airbnb or HomeAway/VRBO) are experiencing an issue. In this case you will most likely need to retry the request after our systems are back in shape - check our Status Page for more information on that.

Response Body Format

The Hospitable API responds in JSON format adhering to the following JSON Schema:

# multiple paginated results
{
  "data": [
    {...},
    {...}
  ],
  "meta": {
    "current_page" : 1,
    "last_page" : 10,
    "per_page" : 10,
    "from" : 1,
    "to" : 10,
    "total" : 100,
    "links" : {...}
}

📘

Includes

See Pagination for more information on paginating results.

# single result
{
  "data": {
    #...
  }
}

A further explanation of this schema:

  • data: The requested data, either as an entity or array of entities (if multiple were requested).
  • meta: Further information alongside the request, possibly including links to other resources, pagination details, and any warnings (e.g. if a deprecated version of the resource was requested).

📘

Includes

See Including Resources for more information on requesting a superset JSON result of a resource.

Unique request ID

Every response from the Public API contains an X-hospitable-trace header which provides the unique ID given to the request:

X-hospitable-trace: 'b4bc88fd9b8446768bde07864e6ee263'