Properties

Returns a paginated list of properties in your group-level API key.

Note: This endpoint is only available for group-level keys. If you are integrating for a single property, use GET /properties/{propertyUuid} directly.

API: Direct Booking · Operation: Properties · Direction: SM → Property · Method: Pull (Property-initiated)

List properties

get

Retrieves the uuid and name for every property you have access to.

Authorizations

x-sm-api-keystringRequired

Query parameters

pageinteger · min: 1Optional

page number (defaults to 1)

Default: 1

perPageinteger · min: 1 · max: 50Optional

items per page (defaults to 10)

Default: 10

Header parameters

x-sm-api-keystringRequired

API key used to authenticate the request.

Responses

200

OK

application/json

and

400

Bad Request

application/json

401

Not Authorised

application/json

403

Access Denied

application/json

404

The specified resource was not found

application/json

429

Rate Limited

application/json

500

Internal Server Error

application/json

get/properties

GET /properties HTTP/1.1
x-sm-api-key: text
Accept: */*

{
  "results": [
    {
      "uuid": "f63ce398-da03-4573-856d-ed8d71e57e3d",
      "name": "Demo Hotel"
    }
  ],
  "page": 1,
  "perPage": 1,
  "total": 1,
  "totalPages": 1
}

Still have questions?

Use the Ask button at the top of the page to chat with our AI assistant — it can help you navigate the guide, understand requirements, and troubleshoot issues.

If you need more support, visit Integration Support.