# Get Stickers

This endpoint retrieves the Stickers that have been put on a given Twin that are visible to the user sending the request.

Method Path Operation*
GET /twins/{twin}/stickers/ get_stickers

*

In order for a user to perform the "get_stickers" operation, the "get_stickers" permission must be included in the list of allowed actions in the statement of the user's role.

# Request

Parameter Type In Description
{twin}
required
string path Twin UUID.
context
optional*
string, value is {account}, personal, or system; DEFAULT=personal query string You can narrow down the list of Stickers to be included in the search:
- {account}: Account UUID of the account where the Sticker was created.
- personal: Stickers for which the requesting user is the recipient.
- system: Stickers in the entire Trusted Twin system visible to the requesting user.

*

If no context parameter is provided, the default value (context=personal) is used and only Stickers created by the account of the requesting using where he is on the `"recipients" list are returned.

# Response

Attribute Type Description
message string Message for the recipients of the Sticker. The maximum length of a message 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).

The response returns a list of Stickers for the requested Twin grouped by account UUIDs.

# Status codes

Requests to this endpoint result in generic status codes. For a comprehensive list of status codes, please consult the Status codes section.