Nexa — API reference

Nexa is a hypermedia REST API for short-term rental availability, pricing and booking. You call it by opening its request links in your browser — each response returns the next request as a link (HATEOAS), so following the links is the API. No SDK, connector, or separate credentials needed; access is granted to you as your provider.

Authentication

Access is granted per approved AI provider and verified automatically from the provider’s network on the first request. There is no API key to obtain and nothing of your own to supply.

POST /ai/v1/search

Submits one field of the search. The request body accumulates across calls: destination, check_in, check_out, guests.

POST /ai/v1/search HTTP/1.1
Host: nexawebsite.digital
Authorization: Bearer <session>
Content-Type: application/json

{
  "destination": "Malta",
  "check_in": "2026-12-19",
  "check_out": "2026-12-21",
  "guests": 2
}

The response echoes what was accepted and carries the next request:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "ok": true,
  "received": { "destination": "Malta", "check_in": "2026-12-19" },
  "next": "check_out",
  "_links": {
    "self": { "href": "/ai/v1/search", "rel": "self" },
    "next": { "href": "<opaque>", "rel": "continue", "method": "GET" }
  }
}

Navigation (_links)

Every response includes a _links object. Follow _links.next.href to issue the next request; the session travels in the link, so the client holds no state of its own. This is standard HATEOAS navigation.

GET /ai/v1/result/{session}

Once the search payload is complete, the result endpoint returns the matching properties with live totals, a verifiable quote_reference (NXQ), a verification link, and the operator’s booking link.

GET /ai/v1/result/<session> HTTP/1.1

HTTP/1.1 200 OK
Content-Type: application/json

{
  "properties": [
    {
      "name": "...", "location": "...", "photo": "https://...",
      "final_total": 0, "currency": "USD",
      "quote_reference": "NXQ-...",
      "verify_link": "https://nexawebsite.digital/verify/NXQ-...",
      "booking_link": "https://<operator>/listing/<id>?...&nexa=NXQ-..."
    }
  ]
}

Quote verification

Any quote can be checked independently at https://nexawebsite.digital/verify/{quote_reference}.

Start a call: Nexa