![Favicon.png]](../assets/Favicon-9c0fc0b5ec.png){kind=small}
GET history 📰
Get the audit history of records/media at the time they happened. For example, if you had access to a record at the time it was edited you can see that log.
Resource URL
https://{MEDIACONTROLCENTRE_HOST}[:PORT]/imcc/v1/history
| Response formats | XML |
| Requires authentication? | Yes |
| Required scope(s) | Read user data |
⚠️Caution: The user who created the application will only see history if they had access to the record/media at the time of the history log
Parameters
Arguments should be supplied as query parameters in the manner shown below
?query={Media ID or Record ID}
&type = create/edit/delete
&limit = nnnn limit on number of results. Default 48. Max 100
?start = mmmm start if paging through history
?sort = modifiedDate desc or asc currently supported.
?recordID = search by record ID
?getTotalCount = boolean, if true and start = 0 then get total hits for the search
?userID = search by user ID
Example REST request
M.edia object id: 83
https://{MEDIACONTROLCENTRE_HOST-FQDN}[:PORT]/imcc/v1/history
Example Response
Returns success, or an error response on failure.
Response on success
...
Response on failure
500
<?xml version="1.0" encoding="UTF-8"?>
<Error>
<Message>Failed to search history.</Message>
<Details></Details>
</Error>
401
<?xml version="1.0" encoding="UTF-8"?>
<Error>
<Message>Some authentication must be supplied.</Message>
</Error>