Skip to content
/
Getting Started
Last updated

Getting Started

Sandbox Access

To access to the sandbox, you need to create an account on the Sandbox Developer Portal. Also see our dedicated page on sandboxes.

After that, please contact us via our support page and we will link your account with Xenia.

In the future this step will be automated for the sandbox.

Once you have received confirmation of us linking your account, you can test your credentials work by calling one of the endpoints such as list webhooks.

curl -i -X GET \
  https://api-xenia-cisandbox.staysitu.com/external-api/v1/webhooks \
  -H 'X-Api-Key: YOUR_API_KEY_HERE'

You should receive a response with a 200 status code.

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
*omitted headers for brevity*
Date: Tue, 26 Aug 2025 14:16:08 GMT

{"data":[]}

To test creating an enquiry, you can use the following curl command:

curl -i -X POST "https://api-xenia-cisandbox.staysitu.com/external-api/v1/enquiries" \
  -H "X-Api-Key: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "test-enquiry-001",
    "clientReference": "CLIENT-TEST-001",
    "enquiryLocation": {
      "addressFormatted": "London, UK, SW1A 1AA"
    },
    "checkInOut": {
      "checkIn": "2026-02-03",
      "checkOut": "2026-02-10"
    },
    "guestNumbers": {
      "adults": 2,
      "children": 1
    },
    "leadGuest": {
      "givenName": "Test",
      "familyName": "User",
      "email": "test@example.com",
      "contactNumber": "+447911123456"
    },
    "clientBooker": {
      "givenName": "Booker",
      "familyName": "Test",
      "email": "booker@example.com",
      "contactNumber": "+447911123457"
    }
  }'

You should receive a response with a 201 status code and the enquiry data.

HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
*omitted headers for brevity*
Date: Tue, 26 Aug 2025 14:16:08 GMT

{
  "data": {
    "xeniaReference": "K3H6B0A4",
    "clientReference": "CLIENT-TEST-001",
    ... (other fields)
  }
}

Production Access

After you have been certified to use the Xenia API in production, you will need to access the production environment.

To do this, create an account on the Production Developer Portal.

After that, please contact us via our support page and we will link your account with Xenia.

Once you have received confirmation of us linking your account, you can test your credentials work by calling one of the endpoints such as list webhooks.

curl -i -X GET \
  https://api-xenia.staysitu.com/external-api/v1/webhooks \
  -H 'X-Api-Key: YOUR_API_KEY_HERE'
Previous page
Next page