# 4.25. Organisation Administrator - View organisation audit logs

<table border="1" id="bkmrk-id-4.1.-description-" style="border-collapse: collapse; width: 100%; height: 315px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29px;"><td style="height: 29px;">**Id**</td><td style="height: 29px;">4.25.</td></tr><tr style="height: 141px;"><td style="height: 141px;">**Description**</td><td style="height: 141px;">As an **<span class="notion-enable-hover" data-token-index="1">Organisation Administrator</span>**,

I want to have access to audit logs of all the actions perform by the users assigned to my organisation

So that I can find out what actions have been performed in the system and by whom

</td></tr><tr style="height: 29px;"><td style="height: 29px;">**Priority**</td><td style="height: 29px;"><span style="color: rgb(35, 111, 161);">**Low**</span></td></tr><tr style="height: 29px;"><td style="height: 29px;">**Actors**</td><td style="height: 29px;">Organisation Administrator</td></tr><tr style="height: 29px;"><td style="height: 29px;">**API Calls**</td><td style="height: 29px;">**GET** /audit-logs

**GET** /audit-logs/&lt;audit\_log\_id&gt;

</td></tr><tr style="height: 29px;"><td style="height: 29px;">**Linked Processes**</td><td style="height: 29px;">  
</td></tr><tr style="height: 29px;"><td style="height: 29px;">**Status**</td><td style="height: 29px;">**<span style="color: rgb(22, 145, 121);">Implemented</span>**</td></tr></tbody></table>

### Preconditions

1. The User must be authenticated and have the<span class="notion-enable-hover" data-token-index="1"> **Organisation Administrator**</span> role.

### Postconditions

1. The System returns the list of audit logs that are linked to users that belong to the Organisation Administrator’s organisation.

### Main flow

1. The **Organisation Administrator** retrieves the audit logs using the API (GET). Optionally the **Organisation Administrator** can filter logs linked to to a specific:
    
    
    - user of the Organisation Administrator’s organisation
    - site
    - block
    - unit
    
    The user can also specify a time range of interest.
2. The system validates the request parameters.
3. The system returns the list of audit logs that match the query and are linked to the Organisation Administrator’s organisation.

### Exceptions

#### \[400 Bad Request\] Invalid input:

If mandatory fields are missing or invalid, the system returns an error message.

#### \[404 Not found\] Data not found

If the **Organisation Administrator** attempts to retrieve audit logs using filters for resources that do not exist or belong to another organisation, the system will return an error.

#### \[500 Internal Server Error\] System Error

If the system fails to save changes due to an internal error, it displays an appropriate message and logs the error for further investigation.