# List Stickers
This endpoint lists Stickers where the calling user is the recipient of the Sticker (i.e., the user, role or account UUID is on the
"recipients" list of the Sticker).
By default, the endpoint lists only Stickers create in the account of the calling user. To widen the search, the user can add a query parameter to see all Stickers where they are on the recipients list regardless of the account where the Stickers were created (
context=system) or Stickers which were created by an account with a given account UUID (
In order for a user to perform the "list_stickers" operation, the "list_stickers" permission must be included in the list of allowed actions in the statement of the user's role.
|string||query string||Color of the sticker to be returned in the response.|
|string, value is ||query string||You can narrow down the list of Stickers to be included in the search:|
|timestamp||query string||Returns Stickers where creation timestamp is greater than or equal to the given Unix(opens new window) timestamp.|
|timestamp||query string||Returns Stickers where creation timestamp is lower than or equal to the given Unix(opens new window) timestamp.|
|integer, ||query string||Limit on the number of Stickers to be returned in descending order. The descending order is calculated taking into account the |
|integer, ||query string||Determines the offset from which the records are to be provided. The records are provided in descending order (i.e., starting from the most recent record).|
color key is specified, all Stickers will be returned in the response filtered by other parameters if such parameters are provided.
context parameter is provided, the default value (
context=personal) is used and only Stickers created by the account of the requesting user where they are on the
"recipients" list are returned.
offset parameters are optional and do not need to be included in the request. If they are not included in the request, their default values are used. If the number of the records to be returned exceeds the
limit provided in the request:
- if the
geparameter is provided, the records to be returned are counted starting from the timestamp provided.
- if the
leparameter is provided, the records to be returned are counted from the timestamp provided.
- if both
leparameters are provided, the records to be returned are counted from the timestamp provided in the
leparameter (i.e., the most recent records are returned).
|color||string||User-defined category of the sticker. It must be unique in the context of an account. It must match the regular expression(opens new window) |
|account||string||Account UUID of the account that created the Sticker.|
|twin||string||Twin UUID of the Twin with the Sticker.|
|note||string||Note for the recipients of the Sticker. The maximum length of a note is 256 characters.|
|validity_ts||timestamp||Time at which the Sticker expires. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch(opens new window).|
|created_ts||timestamp||Time at which the Sticker was created. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch(opens new window).|
# Status codes
Requests to this endpoint result in generic status codes. For a comprehensive list of status codes, please consult the Status codes section.