> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nx1cloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search an audit stream

> Search an audit stream to find out who did what in NexusOne.

You search an audit stream to find out who did what in NexusOne, such as who accessed a table or which user called an
API. The audit page keeps these records in five streams, and you search one stream at a time.

## Prerequisites

Before starting this task, ensure you have the following:

* Required roles: `nx1_audit_viewer`.
* An audit store that your platform administrator configured.

## Search an audit stream

> [tab] Web portal
>
> Perform these steps to search an audit stream:
>
> 1. Log in to NexusOne.
>
> 2. On the top navigation bar, hover your mouse over **Govern** and then select **Audit**.
>
> 3. Click the tab of the stream you want to search:
>
>    * **Data Access**: Who accessed which resource, and whether the policy allowed it.
>    * **API calls**: Each authenticated call to the NexusOne API, and every access denial.
>    * **MCP tool calls**: Each tool called over MCP, without the values of its arguments.
>    * **Business rules**: Rule evaluations and governance actions, such as approvals.
>    * **AI Router**: Each routing decision, including the model chosen and its cost.
>
> 4. Set any of the following:
>
>    * **From** and **To**: The date and time to start and end the search.
>    * **Free text**: A phrase to find in the `reason` or `denied_reason` field of the JSON output of an event. It
>      appears only on **Data Access**, **API calls**, and **Business rules**.
>
> 5. Optional: To filter on a field, click **Add filter**. A row appears with the following, from left to right:
>
>    * **Field**: The field to filter on. Click the list to see every field of the stream. The following are examples:
>
>      * **Data Access**: Time, Access type, and Resource
>      * **API calls**: Time, Method, and Path
>      * **MCP tool calls**: Time, Tool, and Outcome
>      * **Business rules**: Time, Event, and Decision
>      * **AI Router**: Time, Model used, and Decision
>
>    * **The comparison list**: How the field should match the value. For **Time**, the options are **is at least**,
>      **is at most**, and **is present**. Other fields have other options.
>
>    * **Value**: What to compare it with. For **Time** and **is at most**, enter an ISO 8601 date and time, such as
>      `2026-11-17T09:00:00Z`.
>
> 6. Optional: To add more filters, repeat step 5. To remove a filter, click the remove icon at the end of its row.
>
> 7. Click **Search**. NexusOne shows the matching events in a table. If nothing matches, then the page says
>    **No events match**.
>
> 8. Optional: To see more events, click **Next**. NexusOne shows 50 events at a time.
>
> 9. Optional: To start over, click **Clear filters**.

> [tab] REST API
>
> Use the following API endpoints to search an audit stream:
>
> * [List audit streams and their searchable fields](https://docs.nx1cloud.com/api-reference/endpoints/audit/list-audit-streams-and-their-searchable-fields.md)
> * [Search one audit stream](https://docs.nx1cloud.com/api-reference/endpoints/audit/search-one-audit-stream.md)

## Additional resources

* For an overview of the Govern feature, refer to [Govern Overview](https://docs.nx1cloud.com/documentation/govern/overview).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.