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)

Paginates all properties based on permissions

get

Retrieve the uuid and name for all properties which you have access to

Authorizations

x-sm-api-keystringRequired

Query parameters

pageinteger · min: 1Optional

page number (defaults to 1)

perPageinteger · min: 1 · max: 50Optional

items per page (defaults to 10)

Default: 10

Header parameters

x-sm-api-keystringRequired

access token retrieved from Multi-Property Platform

Responses

200

OK

application/json

and

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

503

Service Unavailable

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.