# Get an Identity
This endpoint retrieves the details of the requested Identity of a given Twin. It can be called only for Identities owned by the account of the requesting user.
In order for a user to perform the "get_twin_identity" operation, the "get_twin_identity" permission must be included in the list of allowed actions in the statement of the user's role.
|string||path||User-defined ID for the Identity. It must match the regular expression (opens new window) |
|visibility||string||Visibility of the Identity. If the value is |
|validity_ts||timestamp||Time at which the Identity expires. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch (opens new window). If the value is |
|updated_ts||timestamp||Time at which the Identity was last updated. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch (opens new window).|
Certificate generated automatically by the system upon creation of the Identity. The creation certificate cannot be modified after it has been generated.
# Status codes
Requests to this endpoint result in generic status codes. For a comprehensive list of status codes, please consult the Status Codes section.