Views

Get a saved view

Changed on

Retrieve a single saved view by its ID. Guesty's predefined views are available to any caller; a view belonging to another account returns 403, and an unknown ID returns 404. Use fields to limit the properties returned.

get/views/{id}

Request

  • Base URL
    https://open-api.guesty.com/v1
  • URL
    https://open-api.guesty.com/v1/views/{id}
  • Auth
    API key in header authorization

Path parameters

idstring required

View ID

Query parameters

fieldsstring

Selection of fields, separated by space

Response

View object

_idstring

Unique id

accountIdstring

Id of the user owning this view

titlestring

Title for the view

fieldsstring

Selection of fields, separated by space

sortstring

ascending sort, use '-' for descending sort

createdAtstring date-time

Timestamp when the view was created.

updatedAtstring date-time

Timestamp when the view was last updated.

Example response

{
  "scheduledEmails": [
    {
      "days": [
        4
      ],
      "hour": 14
    }
  ],
  "shares": [
    {
      "contactId": "5926bdfb1bfe871000d0a745"
    }
  ]
}

Changes