--- id: get-events sidebar_label: Lists all events for the given identity hide_title: true hide_table_of_contents: true api: {"operationId":"getEvents","tags":["Identity History"],"description":"This method retrieves all access events for the identity Requires authorization scope of 'idn:identity-history:read' ","parameters":[{"in":"path","name":"id","schema":{"type":"string"},"required":true,"description":"The identity id","example":"8c190e6787aa4ed9a90bd9d5344523fb"},{"in":"query","name":"from","schema":{"type":"string"},"description":"The optional instant from which to return the access events","example":"2007-03-01T13:00:00Z"},{"in":"query","name":"eventTypes","schema":{"type":"array","items":{"type":"string"}},"description":"An optional list of event types to return. If null or empty, all events are returned","example":["AccessAddedEvent","AccessRemovedEvent"]},{"in":"query","name":"accessItemTypes","schema":{"type":"array","items":{"type":"string"}},"description":"An optional list of access item types (app, account, entitlement, etc...) to return. If null or empty, all access items types are returned","example":["entitlement","account"]},{"in":"query","name":"limit","description":"Max number of results to return.\nSee [V3 API Standard Collection Parameters](https://developer.sailpoint.com/docs/standard_collection_parameters.html) for more information.","required":false,"example":250,"schema":{"type":"integer","format":"int32","minimum":0,"maximum":250,"default":250}},{"in":"query","name":"offset","description":"Offset into the full result set. Usually specified with *limit* to paginate through the results.\nSee [V3 API Standard Collection Parameters](https://developer.sailpoint.com/docs/standard_collection_parameters.html) for more information.","required":false,"example":0,"schema":{"type":"integer","format":"int32","minimum":0,"default":0}},{"in":"query","name":"count","description":"If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored.\n\nSince requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used.\n\nSee [V3 API Standard Collection Parameters](https://developer.sailpoint.com/docs/standard_collection_parameters.html) for more information.","required":false,"example":true,"schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"The list of events for the identity","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"accessItem":{"type":"object","oneOf":[{"type":"object","properties":{"accessType":{"type":"string","example":"accessProfile","description":"the access item type. accessProfile in this case"},"id":{"type":"string","example":"2c918087763e69d901763e72e97f006f","description":"the access item id"},"name":{"type":"string","example":"sample","description":"the access profile name"},"sourceName":{"type":"string","example":"DataScienceDataset","description":"the name of the source"},"sourceId":{"type":"string","example":"2793o32dwd","description":"the id of the source"},"description":{"type":"string","example":"AccessProfile - Workday/Citizenship access","description":"the description for the access profile"},"displayName":{"type":"string","example":"Dr. Arden Rogahn MD","description":"the display name of the identity"},"entitlementCount":{"type":"string","example":12,"description":"the number of entitlements the access profile will create"},"appDisplayName":{"type":"string","example":"AppName","description":"the name of app"}}},{"type":"object","properties":{"accessType":{"type":"string","example":"account","description":"the access item type. account in this case"},"id":{"type":"string","example":"2c918087763e69d901763e72e97f006f","description":"the access item id"},"nativeIdentity":{"type":"string","example":"dr.arden.ogahn.d","description":"the native identifier used to uniquely identify an acccount"},"sourceName":{"type":"string","example":"DataScienceDataset","description":"the name of the source"},"sourceId":{"type":"string","example":"2793o32dwd","description":"the id of the source"},"entitlementCount":{"type":"string","example":12,"description":"the number of entitlements the account will create"},"displayName":{"type":"string","example":"Dr. Arden Rogahn MD","description":"the display name of the identity"}}},{"type":"object","properties":{"accessType":{"type":"string","example":"app","description":"the access item type. entitlement in this case"},"id":{"type":"string","example":"2c918087763e69d901763e72e97f006f","description":"the access item id"},"displayName":{"type":"string","example":"Display Name","description":"the access profile display name"},"sourceName":{"type":"string","example":"appName","description":"the associated source name if it exists"}}},{"type":"object","properties":{"accessType":{"type":"string","example":"entitlement","description":"the access item type. entitlement in this case"},"id":{"type":"string","example":"2c918087763e69d901763e72e97f006f","description":"the access item id"},"attribute":{"type":"string","example":"groups","description":"the entitlement attribute"},"value":{"type":"string","example":"Upward mobility access","description":"the associated value"},"entitlementType":{"type":"string","example":"entitlement","description":"the type of entitlement"},"sourceName":{"type":"string","example":"DataScienceDataset","description":"the name of the source"},"sourceId":{"type":"string","example":"2793o32dwd","description":"the id of the source"},"description":{"type":"string","example":"Entitlement - Workday/Citizenship access","description":"the description for the entitlment"},"displayName":{"type":"string","example":"Dr. Arden Rogahn MD","description":"the display name of the identity"}}},{"type":"object","properties":{"accessType":{"type":"string","example":"role","description":"the access item type. role in this case"},"id":{"type":"string","example":"2c918087763e69d901763e72e97f006f","description":"the access item id"},"displayName":{"type":"string","example":"sample","description":"the role display name"},"description":{"type":"string","example":"Role - Workday/Citizenship access","description":"the description for the role"},"sourceName":{"type":"string","example":"Source Name","description":"the associated source name if it exists"}}}],"example":{"id":"8c190e6787aa4ed9a90bd9d5344523fb","accessType":"account","nativeIdentity":127999,"sourceName":"JDBC Entitlements Source","entitlementCount":0,"displayName":"Sample Name"}},"identityId":{"type":"string","description":"the identity id","example":"8c190e6787aa4ed9a90bd9d5344523fb"},"eventType":{"type":"string","description":"the event type","example":"AccessItemAssociated"},"dt":{"type":"string","description":"the date of event","example":"2019-03-08T22:37:33.901Z"},"governanceEvent":{"example":{"name":"Manager Certification for Jon Snow","dt":"2019-03-08T22:37:33.901Z","type":"certification","governanceId":"2c91808a77ff216301782327a50f09bf","owners":[{"id":"bc693f07e7b645539626c25954c58554","displayName":"Jon Snow"}],"reviewers":[{"id":"bc693f07e7b645539626c25954c58554","displayName":"Jon Snow"}],"decisionMaker":{"id":"bc693f07e7b645539626c25954c58554","displayName":"Jon Snow"}},"type":"object","properties":{"name":{"type":"string","description":"The name of the governance event, such as the certification name or access request ID.","example":"Manager Certification for Jon Snow"},"dt":{"type":"string","description":"The date that the certification or access request was completed.","example":"2019-03-08T22:37:33.901Z"},"type":{"type":"string","enum":["certification","accessRequest"],"description":"The type of governance event.","example":"certification"},"governanceId":{"type":"string","description":"The ID of the instance that caused the event - either the certification ID or access request ID.","example":"2c91808a77ff216301782327a50f09bf"},"owners":{"type":"array","description":"The owners of the governance event (the certifiers or approvers)","items":{"type":"object","properties":{"id":{"type":"string","description":"the id of the certifier","example":"8a80828f643d484f01643e14202e206f"},"displayName":{"type":"string","description":"the name of the certifier","example":"John Snow"}}},"example":[{"id":"8a80828f643d484f01643e14202e206f","displayName":"John Snow"}]},"reviewers":{"type":"array","description":"The owners of the governance event (the certifiers or approvers), this field should be preferred over owners","items":{"type":"object","properties":{"id":{"type":"string","description":"the id of the certifier","example":"8a80828f643d484f01643e14202e206f"},"displayName":{"type":"string","description":"the name of the certifier","example":"John Snow"}}},"example":[{"id":"8a80828f643d484f01643e14202e206f","displayName":"John Snow"}]},"decisionMaker":{"type":"object","properties":{"id":{"type":"string","description":"the id of the certifier","example":"8a80828f643d484f01643e14202e206f"},"displayName":{"type":"string","description":"the name of the certifier","example":"John Snow"}},"description":"The decision maker","example":{"id":"8a80828f643d484f01643e14202e206f","displayName":"John Snow"}}}}}},{"type":"object","properties":{"accessItem":{"type":"object","oneOf":[{"type":"object","properties":{"accessType":{"type":"string","example":"accessProfile","description":"the access item type. accessProfile in this case"},"id":{"type":"string","example":"2c918087763e69d901763e72e97f006f","description":"the access item id"},"name":{"type":"string","example":"sample","description":"the access profile name"},"sourceName":{"type":"string","example":"DataScienceDataset","description":"the name of the source"},"sourceId":{"type":"string","example":"2793o32dwd","description":"the id of the source"},"description":{"type":"string","example":"AccessProfile - Workday/Citizenship access","description":"the description for the access profile"},"displayName":{"type":"string","example":"Dr. Arden Rogahn MD","description":"the display name of the identity"},"entitlementCount":{"type":"string","example":12,"description":"the number of entitlements the access profile will create"},"appDisplayName":{"type":"string","example":"AppName","description":"the name of app"}}},{"type":"object","properties":{"accessType":{"type":"string","example":"account","description":"the access item type. account in this case"},"id":{"type":"string","example":"2c918087763e69d901763e72e97f006f","description":"the access item id"},"nativeIdentity":{"type":"string","example":"dr.arden.ogahn.d","description":"the native identifier used to uniquely identify an acccount"},"sourceName":{"type":"string","example":"DataScienceDataset","description":"the name of the source"},"sourceId":{"type":"string","example":"2793o32dwd","description":"the id of the source"},"entitlementCount":{"type":"string","example":12,"description":"the number of entitlements the account will create"},"displayName":{"type":"string","example":"Dr. Arden Rogahn MD","description":"the display name of the identity"}}},{"type":"object","properties":{"accessType":{"type":"string","example":"app","description":"the access item type. entitlement in this case"},"id":{"type":"string","example":"2c918087763e69d901763e72e97f006f","description":"the access item id"},"displayName":{"type":"string","example":"Display Name","description":"the access profile display name"},"sourceName":{"type":"string","example":"appName","description":"the associated source name if it exists"}}},{"type":"object","properties":{"accessType":{"type":"string","example":"entitlement","description":"the access item type. entitlement in this case"},"id":{"type":"string","example":"2c918087763e69d901763e72e97f006f","description":"the access item id"},"attribute":{"type":"string","example":"groups","description":"the entitlement attribute"},"value":{"type":"string","example":"Upward mobility access","description":"the associated value"},"entitlementType":{"type":"string","example":"entitlement","description":"the type of entitlement"},"sourceName":{"type":"string","example":"DataScienceDataset","description":"the name of the source"},"sourceId":{"type":"string","example":"2793o32dwd","description":"the id of the source"},"description":{"type":"string","example":"Entitlement - Workday/Citizenship access","description":"the description for the entitlment"},"displayName":{"type":"string","example":"Dr. Arden Rogahn MD","description":"the display name of the identity"}}},{"type":"object","properties":{"accessType":{"type":"string","example":"role","description":"the access item type. role in this case"},"id":{"type":"string","example":"2c918087763e69d901763e72e97f006f","description":"the access item id"},"displayName":{"type":"string","example":"sample","description":"the role display name"},"description":{"type":"string","example":"Role - Workday/Citizenship access","description":"the description for the role"},"sourceName":{"type":"string","example":"Source Name","description":"the associated source name if it exists"}}}],"example":{"id":"8c190e6787aa4ed9a90bd9d5344523fb","accessType":"account","nativeIdentity":127999,"sourceName":"JDBC Entitlements Source","entitlementCount":0,"displayName":"Sample Name"}},"identityId":{"type":"string","description":"the identity id","example":"8c190e6787aa4ed9a90bd9d5344523fb"},"eventType":{"type":"string","description":"the event type","example":"AccessItemRemoved"},"dt":{"type":"string","description":"the date of event","example":"2019-03-08T22:37:33.901Z"},"governanceEvent":{"example":{"name":"Manager Certification for Jon Snow","dt":"2019-03-08T22:37:33.901Z","type":"certification","governanceId":"2c91808a77ff216301782327a50f09bf","owners":[{"id":"bc693f07e7b645539626c25954c58554","displayName":"Jon Snow"}],"reviewers":[{"id":"bc693f07e7b645539626c25954c58554","displayName":"Jon Snow"}],"decisionMaker":{"id":"bc693f07e7b645539626c25954c58554","displayName":"Jon Snow"}},"type":"object","properties":{"name":{"type":"string","description":"The name of the governance event, such as the certification name or access request ID.","example":"Manager Certification for Jon Snow"},"dt":{"type":"string","description":"The date that the certification or access request was completed.","example":"2019-03-08T22:37:33.901Z"},"type":{"type":"string","enum":["certification","accessRequest"],"description":"The type of governance event.","example":"certification"},"governanceId":{"type":"string","description":"The ID of the instance that caused the event - either the certification ID or access request ID.","example":"2c91808a77ff216301782327a50f09bf"},"owners":{"type":"array","description":"The owners of the governance event (the certifiers or approvers)","items":{"type":"object","properties":{"id":{"type":"string","description":"the id of the certifier","example":"8a80828f643d484f01643e14202e206f"},"displayName":{"type":"string","description":"the name of the certifier","example":"John Snow"}}},"example":[{"id":"8a80828f643d484f01643e14202e206f","displayName":"John Snow"}]},"reviewers":{"type":"array","description":"The owners of the governance event (the certifiers or approvers), this field should be preferred over owners","items":{"type":"object","properties":{"id":{"type":"string","description":"the id of the certifier","example":"8a80828f643d484f01643e14202e206f"},"displayName":{"type":"string","description":"the name of the certifier","example":"John Snow"}}},"example":[{"id":"8a80828f643d484f01643e14202e206f","displayName":"John Snow"}]},"decisionMaker":{"type":"object","properties":{"id":{"type":"string","description":"the id of the certifier","example":"8a80828f643d484f01643e14202e206f"},"displayName":{"type":"string","description":"the name of the certifier","example":"John Snow"}},"description":"The decision maker","example":{"id":"8a80828f643d484f01643e14202e206f","displayName":"John Snow"}}}}}},{"type":"object","properties":{"changes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"the attribute name"},"previousValue":{"type":"string","description":"the old value of attribute"},"newValue":{"type":"string","description":"the new value of attribute"}},"example":{"name":"firstname","previousValue":"adam","newValue":"zampa"}}},"eventType":{"type":"string","description":"the event type"},"identityId":{"type":"string","description":"the identity id"},"dt":{"type":"string","description":"the date of event"}},"example":{"attributeChanges":{"name":"firstname","previousValue":"adam","newValue":"zampa"},"eventType":"AttributesChanged","identityId":"8a80828f643d484f01643e14202e206f","dt":"2019-03-08T22:37:33.901Z"}},{"type":"object","properties":{"accessRequest":{"description":"the access request details","type":"object","properties":{"requesterId":{"type":"string","example":"2c91808a77ff216301782327a50f09bf","description":"the requester Id"},"requesterName":{"type":"string","example":"Bing C","description":"the requesterName"},"items":{"type":"array","example":[{"operation":"Add","accessItemType":"role","name":"Role-1","decision":"APPROVED","description":"The role descrition","sourceId":"8a80828f643d484f01643e14202e206f","sourceName":"Source1","approvalInfos":[{"name":"John Snow","id":"8a80828f643d484f01643e14202e2000","status":"Approved"}]}],"items":{"type":"object","properties":{"operation":{"type":"string","example":"Add","description":"the access request item operation"},"accessItemType":{"type":"string","example":"role","description":"the access item type"},"name":{"type":"string","example":"Role-1","description":"the name of access request item"},"decision":{"type":"string","example":"APPROVED","enum":["APPROVED","REJECTED"],"description":"the final decision for the access request"},"description":{"type":"string","example":"The role descrition","description":"the description of access request item"},"sourceId":{"type":"string","example":"8a80828f643d484f01643e14202e206f","description":"the source id"},"sourceName":{"type":"string","example":"Source1","description":"the source Name"},"approvalInfos":{"type":"array","example":[{"name":"John Snow","id":"8a80828f643d484f01643e14202e2000","status":"Approved"}],"items":{"type":"object","properties":{"id":{"type":"string","example":"8a80828f643d484f01643e14202e2000","description":"the id of approver"},"name":{"type":"string","example":"John Snow","description":"the name of approver"},"status":{"type":"string","example":"Approved","description":"the status of the approval request"}}}}}}}}},"identityId":{"type":"string","example":"8a80828f643d484f01643e14202e206f","description":"the identity id"},"eventType":{"type":"string","example":"AccessRequested","description":"the event type"},"dt":{"type":"string","example":"2019-03-08T22:37:33.901Z","description":"the date of event"}}},{"type":"object","properties":{"certificationId":{"type":"string","description":"the id of the certification item","example":"2c91808a77ff216301782327a50f09bf"},"certificationName":{"type":"string","description":"the certification item name","example":"Cert name"},"signedDate":{"type":"string","description":"the date ceritification was signed","example":"2019-03-08T22:37:33.901Z"},"certifiers":{"type":"array","description":"this field is deprecated and may go away","items":{"type":"object","properties":{"id":{"type":"string","description":"the id of the certifier","example":"8a80828f643d484f01643e14202e206f"},"displayName":{"type":"string","description":"the name of the certifier","example":"John Snow"}}},"example":[{"id":"8a80828f643d484f01643e14202e206f","displayName":"John Snow"}]},"reviewers":{"type":"array","description":"The list of identities who review this certification","items":{"type":"object","properties":{"id":{"type":"string","description":"the id of the certifier","example":"8a80828f643d484f01643e14202e206f"},"displayName":{"type":"string","description":"the name of the certifier","example":"John Snow"}}},"example":[{"id":"8a80828f643d484f01643e14202e206f","displayName":"John Snow"}]},"signer":{"type":"object","properties":{"id":{"type":"string","description":"the id of the certifier","example":"8a80828f643d484f01643e14202e206f"},"displayName":{"type":"string","description":"the name of the certifier","example":"John Snow"}},"description":"Identity who signed off on the certification","example":{"id":"8a80828f643d484f01643e14202e206f","displayName":"John Snow"}},"eventType":{"type":"string","description":"the event type","example":"IdentityCertified"},"dt":{"type":"string","description":"the date of event","example":"2019-03-08T22:37:33.901Z"}}},{"type":"object","properties":{"eventType":{"type":"string","description":"the event type"},"identityId":{"type":"string","description":"the identity id"},"dt":{"type":"string","description":"the date of event"},"account":{"type":"object","properties":{"id":{"type":"string","description":"the ID of the account in the database"},"nativeIdentity":{"type":"string","description":"the native identifier of the account"},"displayName":{"type":"string","description":"the display name of the account"},"sourceId":{"type":"string","description":"the ID of the source for this account"},"sourceName":{"type":"string","description":"the name of the source for this account"},"entitlementCount":{"type":"integer","description":"the number of entitlements on this account"},"accessType":{"type":"string","description":"this value is always \"account\""}}},"statusChange":{"type":"object","properties":{"previousStatus":{"type":"string","description":"the previous status of the account","enum":["enabled","disabled","locked"]},"newStatus":{"type":"string","description":"the new status of the account","enum":["enabled","disabled","locked"]}}}},"example":{"account":{"id":"2c91808a77ff216301782327a50f09bf","nativeIdentity":127999,"displayName":"Sample Name","sourceId":"8a80828f643d484f01643e14202e206f","sourceName":"JDBC Entitlements Source","entitlementCount":0,"accessType":"account"},"statusChange":{"previousStatus":"enabled","newStatus":"disabled"},"eventType":"AccountStatusChanged","identityId":"8a80828f643d484f01643e14202e206f","date":"2019-03-08T22:37:33.901Z"}}]}},"examples":{"AccessItemAssociated":{"description":"An Access item associated event","value":[{"accessItem":{"id":"8c190e6787aa4ed9a90bd9d5344523fb","accessType":"account","nativeIdentity":127999,"sourceName":"JDBC Entitlements Source","entitlementCount":0,"displayName":"Sample Name"},"eventType":"AccessItemAssociated","identityId":"8a80828f643d484f01643e14202e206f","dt":"2019-03-08T22:37:33.901Z","governanceEvent":{"name":"Access Request 58","dt":"2019-03-08T22:37:33.901Z","type":"accessRequest","governanceId":"2c91808a77ff216301782327a50f09e1","owners":[{"id":"bc693f07e7b645539626c25954c58554","displayName":"Jon Snow"}],"reviewers":[{"id":"bc693f07e7b645539626c25954c58554","displayName":"Jon Snow"}],"decisionMaker":{"id":"bc693f07e7b645539626c25954c58554","displayName":"Jon Snow"}}}]},"AccessItemRemoved":{"description":"An Access item removed event","value":[{"accessItem":{"id":"8c190e6787aa4ed9a90bd9d5344523fb","accessType":"account","nativeIdentity":127999,"sourceName":"JDBC Entitlements Source","entitlementCount":0,"displayName":"Sample Name"},"eventType":"AccessItemRemoved","identityId":"8a80828f643d484f01643e14202e206f","dt":"2019-03-08T22:37:33.901Z","governanceEvent":{"name":"Manager Certification for Jon Snow","dt":"2019-03-08T22:37:33.901Z","type":"certification","governanceId":"2c91808a77ff216301782327a50f09bf","owners":[{"id":"bc693f07e7b645539626c25954c58554","displayName":"Jon Snow"}],"reviewers":[{"id":"bc693f07e7b645539626c25954c58554","displayName":"Jon Snow"}],"decisionMaker":{"id":"bc693f07e7b645539626c25954c58554","displayName":"Jon Snow"}}}]},"AttributesChanged":{"description":"An attribute changed event","value":[{"attributeChanges":[{"name":"firstname","previousValue":"adam","newValue":"zampa"}],"eventType":"AttributesChanged","identityId":"8a80828f643d484f01643e14202e206f","dt":"2019-03-08T22:37:33.901Z"}]},"AccessRequested":{"description":"An access requested event","value":{"accessRequest":{"requesterId":"2c91808a77ff216301782327a50f09bf","requestName":"Bing C","items":[{"operation":"Add","accessItemType":"role","name":"Role-1","decision":"APPROVED","description":"The role descrition","sourceId":"8a80828f643d484f01643e14202e206f","sourceName":"Source1","approvalInfos":[{"name":"John Snow","id":"8a80828f643d484f01643e14202e2000","status":"Approved"}]}]},"eventType":"AccessRequested","identityId":"8a80828f643d484f01643e14202e206f","dt":"2019-03-08T22:37:33.901Z"}},"IdentityCertified":{"description":"An identity certified event","value":[{"certification":{"id":"2c91808a77ff216301782327a50f09bf","name":"Cert name","signedDate":"2019-03-08T22:37:33.901Z","certifiers":[{"id":"8a80828f643d484f01643e14202e206f","displayName":"John Snow"}],"reviewers":[{"id":"8a80828f643d484f01643e14202e206f","displayName":"Daenerys Targaryen"}],"signer":{"id":"8a80828f643d484f01643e14202e206f","displayName":"Tyrion Lannister"}},"eventType":"IdentityCertified","identityId":"8a80828f643d484f01643e14202e206f","dt":"2019-03-08T22:37:33.901Z"}]},"AccountStatusChanged":{"description":"An account status changed event","value":[{"account":{"id":"2c91808a77ff216301782327a50f09bf","nativeIdentity":127999,"displayName":"Sample Name","sourceId":"8a80828f643d484f01643e14202e206f","sourceName":"JDBC Entitlements Source","entitlementCount":0,"accessType":"account"},"statusChange":{"previousStatus":"ENABLED","newStatus":"DISABLED"},"eventType":"AccountStatusChanged","identityId":"8a80828f643d484f01643e14202e206f","dt":"2019-03-08T22:37:33.901Z"}]}}}}},"400":{"description":"Client Error - Returned if the request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"detailCode":{"type":"string","description":"Fine-grained error code providing more detail of the error.","example":"400.1 Bad Request Content"},"trackingId":{"type":"string","description":"Unique tracking id for the error.","example":"e7eab60924f64aa284175b9fa3309599"},"messages":{"type":"array","description":"Generic localized reason for error","items":{"type":"object","properties":{"locale":{"type":"string","description":"The locale for the message text, a BCP 47 language tag.","example":"en-US"},"localeOrigin":{"type":"string","enum":["DEFAULT","REQUEST"],"description":"An indicator of how the locale was selected. *DEFAULT* means the locale is the system default. *REQUEST* means the locale was selected from the request context (i.e., best match based on the *Accept-Language* header). Additional values may be added in the future without notice.","example":"DEFAULT"},"text":{"type":"string","description":"Actual text of the error message in the indicated locale.","example":"The request was syntactically correct but its content is semantically invalid."}}}},"causes":{"type":"array","description":"Plain-text descriptive reasons to provide additional detail to the text provided in the messages field","items":{"type":"object","properties":{"locale":{"type":"string","description":"The locale for the message text, a BCP 47 language tag.","example":"en-US"},"localeOrigin":{"type":"string","enum":["DEFAULT","REQUEST"],"description":"An indicator of how the locale was selected. *DEFAULT* means the locale is the system default. *REQUEST* means the locale was selected from the request context (i.e., best match based on the *Accept-Language* header). Additional values may be added in the future without notice.","example":"DEFAULT"},"text":{"type":"string","description":"Actual text of the error message in the indicated locale.","example":"The request was syntactically correct but its content is semantically invalid."}}}}}}}}},"401":{"description":"Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"description":"A message describing the error","example":"JWT validation failed: JWT is expired"}}}}}},"403":{"description":"Forbidden - Returned if the user you are running as, doesn't have access to this end-point.","content":{"application/json":{"schema":{"type":"object","properties":{"detailCode":{"type":"string","description":"Fine-grained error code providing more detail of the error.","example":"400.1 Bad Request Content"},"trackingId":{"type":"string","description":"Unique tracking id for the error.","example":"e7eab60924f64aa284175b9fa3309599"},"messages":{"type":"array","description":"Generic localized reason for error","items":{"type":"object","properties":{"locale":{"type":"string","description":"The locale for the message text, a BCP 47 language tag.","example":"en-US"},"localeOrigin":{"type":"string","enum":["DEFAULT","REQUEST"],"description":"An indicator of how the locale was selected. *DEFAULT* means the locale is the system default. *REQUEST* means the locale was selected from the request context (i.e., best match based on the *Accept-Language* header). Additional values may be added in the future without notice.","example":"DEFAULT"},"text":{"type":"string","description":"Actual text of the error message in the indicated locale.","example":"The request was syntactically correct but its content is semantically invalid."}}}},"causes":{"type":"array","description":"Plain-text descriptive reasons to provide additional detail to the text provided in the messages field","items":{"type":"object","properties":{"locale":{"type":"string","description":"The locale for the message text, a BCP 47 language tag.","example":"en-US"},"localeOrigin":{"type":"string","enum":["DEFAULT","REQUEST"],"description":"An indicator of how the locale was selected. *DEFAULT* means the locale is the system default. *REQUEST* means the locale was selected from the request context (i.e., best match based on the *Accept-Language* header). Additional values may be added in the future without notice.","example":"DEFAULT"},"text":{"type":"string","description":"Actual text of the error message in the indicated locale.","example":"The request was syntactically correct but its content is semantically invalid."}}}}}},"examples":{"403":{"summary":"An example of a 403 response object","value":{"detailCode":"403 Forbidden","trackingId":"b21b1f7ce4da4d639f2c62a57171b427","messages":[{"locale":"en-US","localeOrigin":"DEFAULT","text":"The server understood the request but refuses to authorize it."}]}}}}}},"404":{"description":"Not Found - returned if the request URL refers to a resource or object that does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"detailCode":{"type":"string","description":"Fine-grained error code providing more detail of the error.","example":"400.1 Bad Request Content"},"trackingId":{"type":"string","description":"Unique tracking id for the error.","example":"e7eab60924f64aa284175b9fa3309599"},"messages":{"type":"array","description":"Generic localized reason for error","items":{"type":"object","properties":{"locale":{"type":"string","description":"The locale for the message text, a BCP 47 language tag.","example":"en-US"},"localeOrigin":{"type":"string","enum":["DEFAULT","REQUEST"],"description":"An indicator of how the locale was selected. *DEFAULT* means the locale is the system default. *REQUEST* means the locale was selected from the request context (i.e., best match based on the *Accept-Language* header). Additional values may be added in the future without notice.","example":"DEFAULT"},"text":{"type":"string","description":"Actual text of the error message in the indicated locale.","example":"The request was syntactically correct but its content is semantically invalid."}}}},"causes":{"type":"array","description":"Plain-text descriptive reasons to provide additional detail to the text provided in the messages field","items":{"type":"object","properties":{"locale":{"type":"string","description":"The locale for the message text, a BCP 47 language tag.","example":"en-US"},"localeOrigin":{"type":"string","enum":["DEFAULT","REQUEST"],"description":"An indicator of how the locale was selected. *DEFAULT* means the locale is the system default. *REQUEST* means the locale was selected from the request context (i.e., best match based on the *Accept-Language* header). Additional values may be added in the future without notice.","example":"DEFAULT"},"text":{"type":"string","description":"Actual text of the error message in the indicated locale.","example":"The request was syntactically correct but its content is semantically invalid."}}}}}},"examples":{"404":{"summary":"An example of a 404 response object","value":{"detailCode":"404 Not found","trackingId":"b21b1f7ce4da4d639f2c62a57171b427","messages":[{"locale":"en-US","localeOrigin":"DEFAULT","text":"The server did not find a current representation for the target resource."}]}}}}}},"429":{"description":"Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"description":"A message describing the error","example":" Rate Limit Exceeded "}}}}}},"500":{"description":"Internal Server Error - Returned if there is an unexpected error.","content":{"application/json":{"schema":{"type":"object","properties":{"detailCode":{"type":"string","description":"Fine-grained error code providing more detail of the error.","example":"400.1 Bad Request Content"},"trackingId":{"type":"string","description":"Unique tracking id for the error.","example":"e7eab60924f64aa284175b9fa3309599"},"messages":{"type":"array","description":"Generic localized reason for error","items":{"type":"object","properties":{"locale":{"type":"string","description":"The locale for the message text, a BCP 47 language tag.","example":"en-US"},"localeOrigin":{"type":"string","enum":["DEFAULT","REQUEST"],"description":"An indicator of how the locale was selected. *DEFAULT* means the locale is the system default. *REQUEST* means the locale was selected from the request context (i.e., best match based on the *Accept-Language* header). Additional values may be added in the future without notice.","example":"DEFAULT"},"text":{"type":"string","description":"Actual text of the error message in the indicated locale.","example":"The request was syntactically correct but its content is semantically invalid."}}}},"causes":{"type":"array","description":"Plain-text descriptive reasons to provide additional detail to the text provided in the messages field","items":{"type":"object","properties":{"locale":{"type":"string","description":"The locale for the message text, a BCP 47 language tag.","example":"en-US"},"localeOrigin":{"type":"string","enum":["DEFAULT","REQUEST"],"description":"An indicator of how the locale was selected. *DEFAULT* means the locale is the system default. *REQUEST* means the locale was selected from the request context (i.e., best match based on the *Accept-Language* header). Additional values may be added in the future without notice.","example":"DEFAULT"},"text":{"type":"string","description":"Actual text of the error message in the indicated locale.","example":"The request was syntactically correct but its content is semantically invalid."}}}}}},"examples":{"500":{"summary":"An example of a 500 response object","value":{"detailCode":"500.0 Internal Fault","trackingId":"b21b1f7ce4da4d639f2c62a57171b427","messages":[{"locale":"en-US","localeOrigin":"DEFAULT","text":"An internal fault occurred."}]}}}}}}},"method":"get","path":"/historical-identities/{id}/events","servers":[{"url":"https://{tenant}.api.identitynow.com/beta","description":"This is the beta API server.","variables":{"tenant":{"default":"sailpoint","description":"This is the name of your tenant, typically your company's name."}}}],"security":[{"oauth2":[]}],"securitySchemes":{"oauth2":{"type":"oauth2","description":"OAuth2 Bearer token (JWT). See [IdentityNow REST API Authentication](https://developer.sailpoint.com/docs/authentication.html) for more information.\n- Directions for generating a [personal access token](https://developer.sailpoint.com/docs/authentication.html#personal-access-tokens)\n- Directions using [client credentials flow](https://developer.sailpoint.com/docs/authentication.html#client-credentials-grant-flow)\n- Directions for using [authorization code flow](https://developer.sailpoint.com/docs/authentication.html#authorization-code-grant-flow)\n\nWhich authentication method should I choose? See our [guide](https://developer.sailpoint.com/docs/authentication.html#which-oauth-2-0-grant-flow-should-i-use)\n\nLearn more about how to find your `tokenUrl` and `authorizationUrl` [in our docs](https://developer.sailpoint.com/docs/authentication.html#finding-your-tenant-s-oauth-details)\n","flows":{"clientCredentials":{"tokenUrl":"https://tenant.api.identitynow.com/oauth/token","scopes":{"sp:scopes:default":"default scope","sp:scopes:all":"access to all scopes"}},"authorizationCode":{"authorizationUrl":"https://tenant.identitynow.com/oauth/authorize","tokenUrl":"https://tenant.api.identitynow.com/oauth/token","scopes":{"sp:scopes:default":"default scope","sp:scopes:all":"access to all scopes"}}}}},"info":{"contact":{"email":"developers@sailpoint.com","name":"Developer Relations","url":"https://developer.sailpoint.com/discuss"},"description":"These are the public, beta APIs for SailPoint's SaaS services and are subject to change.","title":"SailPoint - Beta SaaS API","version":"3.1.0-beta"},"postman":{"name":"Lists all events for the given identity","description":{"content":"This method retrieves all access events for the identity Requires authorization scope of 'idn:identity-history:read' ","type":"text/plain"},"url":{"path":["historical-identities",":id","events"],"host":["{{baseUrl}}"],"query":[{"disabled":false,"description":{"content":"The optional instant from which to return the access events","type":"text/plain"},"key":"from","value":""},{"disabled":false,"description":{"content":"An optional list of event types to return. If null or empty, all events are returned","type":"text/plain"},"key":"eventTypes","value":""},{"disabled":false,"description":{"content":"An optional list of access item types (app, account, entitlement, etc...) to return. If null or empty, all access items types are returned","type":"text/plain"},"key":"accessItemTypes","value":""},{"disabled":false,"description":{"content":"Max number of results to return.\nSee [V3 API Standard Collection Parameters](https://developer.sailpoint.com/docs/standard_collection_parameters.html) for more information.","type":"text/plain"},"key":"limit","value":""},{"disabled":false,"description":{"content":"Offset into the full result set. Usually specified with *limit* to paginate through the results.\nSee [V3 API Standard Collection Parameters](https://developer.sailpoint.com/docs/standard_collection_parameters.html) for more information.","type":"text/plain"},"key":"offset","value":""},{"disabled":false,"description":{"content":"If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored.\n\nSince requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used.\n\nSee [V3 API Standard Collection Parameters](https://developer.sailpoint.com/docs/standard_collection_parameters.html) for more information.","type":"text/plain"},"key":"count","value":""}],"variable":[{"disabled":false,"description":{"content":"(Required) The identity id","type":"text/plain"},"type":"any","value":"","key":"id"}]},"header":[{"key":"Accept","value":"application/json"}],"method":"GET"}} sidebar_class_name: "get api-method" info_path: docs/sailpoint-api-beta/sail-point-beta-saa-s-api --- import ApiTabs from "@theme/ApiTabs"; import MimeTabs from "@theme/MimeTabs"; import ParamsItem from "@theme/ParamsItem"; import ResponseSamples from "@theme/ResponseSamples"; import SchemaItem from "@theme/SchemaItem" import SchemaTabs from "@theme/SchemaTabs"; import DiscriminatorTabs from "@theme/DiscriminatorTabs"; import TabItem from "@theme/TabItem"; ## Lists all events for the given identity This method retrieves all access events for the identity Requires authorization scope of 'idn:identity-history:read'
Path Parameters
Query Parameters
The list of events for the identity
Schema array
  • anyOf
    accessItem object
  • oneOf
    • governanceEvent object
    owners object[]
    The owners of the governance event (the certifiers or approvers)
    reviewers object[]
    The owners of the governance event (the certifiers or approvers), this field should be preferred over owners
    decisionMaker object
    The decision maker
    accessItem object
  • oneOf
    • governanceEvent object
    owners object[]
    The owners of the governance event (the certifiers or approvers)
    reviewers object[]
    The owners of the governance event (the certifiers or approvers), this field should be preferred over owners
    decisionMaker object
    The decision maker
    changes object[]
    accessRequest object
    the access request details
    items object[]
    approvalInfos object[]
    certifiers object[]
    this field is deprecated and may go away
    reviewers object[]
    The list of identities who review this certification
    signer object
    Identity who signed off on the certification
    account object
    statusChange object
Client Error - Returned if the request body is invalid.
Schema
    messages object[]
    Generic localized reason for error
    causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
Schema
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
Schema
    messages object[]
    Generic localized reason for error
    causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
Not Found - returned if the request URL refers to a resource or object that does not exist
Schema
    messages object[]
    Generic localized reason for error
    causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.
Schema
Internal Server Error - Returned if there is an unexpected error.
Schema
    messages object[]
    Generic localized reason for error
    causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field