GUguesty
Users

List all users

List all users

get/users

Request

  • Base URL
    https://open-api.guesty.com/v1
  • URL
    https://open-api.guesty.com/v1/users
  • Auth
    API key in header authorization

Query parameters

fieldsstring

Selection of fields, separated by space. If fields not be chosen response will be return with all fields. The selected fields from the users table will be returned inside the response

skipnumber

Pagination

limitnumber

Pagination, max: 200

sortstring

Sorting

qstring

Search query string. Searches in fullName, emails, phones

Response

Successful response

countnumber required
fieldsstring required
sortstring required
skipnumber required
limitnumber required

Example response

{
  "count": 42,
  "fields": "fullName",
  "sort": "fullName",
  "skip": 20,
  "limit": 10,
  "results": [
    {
      "_id": "611d02b7c9c54b01736ae01d",
      "accountId": "611cf837c9c54b01736ae01c",
      "email": "example@email.com",
      "emails": [
        "example@email.com"
      ],
      "firstName": "John",
      "lastName": "Boe",
      "fullName": "John Boe",
      "title": "CTO",
      "timezone": "Europe/Zurich",
      "picture": {
        "thumbnail": "https://thumbnail.url.com",
        "regular": "https://regular.url.com",
        "large": "https://large.url.com"
      },
      "tags": [
        "tag1"
      ],
      "settings": {
        "notifications": {
          "subscriptions": [
            {
              "type": "PAYMENT",
              "name": "FAILED",
              "targets": [
                "DASHBOARD"
              ]
            }
          ]
        }
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.