> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xano.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Request History
The Metadata API enables you to interact with the API Request History of a given instance.
### Browse Workspace Request History
Browse is a straightforward approach to getting API Request History. The required parameter is the workspace ID. However, you can drill down further with the branch, API Group, or specific API Endpoint.
**Required Parameters**
* Workspace ID (workspace\_id)
**Optional Parameters**
* Branch ID (branch\_id) - Workspace Branch ID.
* API ID (api\_id) - The API Group ID.
* Query ID (query\_id) - The ID of a specific API Endpoint.
* Page
* Per\_Page - (500 max)
* include\_output - (true or false) - If you want to include the output of each API request.
### Search
Search workspace history allows for granular filtering and sorting of a workspace's API Request History.
Request History is similar to [content search](/xano-features/metadata-api/content#search-and-browse-content), except instead of fields for searching and filtering, request history uses the same options from the Xano dashboard.
* duration - duration of an API request, in seconds.
* status - the status code.
* created\_at - the time of execution, as a timestamp in milliseconds.
#### Examples:
**Search for requests with a duration of less than 2 seconds. Sort by the longest duration.**
In this example, we are searching for requests with a duration less than 2 seconds and sorting the results by duration in descending order.
Example request body:
```json theme={null}
{
"page": 1,
"per_page": 50,
"branch_id": null,
"api_id": null,
"query_id": null,
"sort": {
"duration": "desc"
},
"search": [
{
"duration|<|": 2
}
]
}
```
**Search for Reqeusts with a status code of 400. Sort the Results by oldest.**
Example Request Body:
```json theme={null}
{
"page": 1,
"per_page": 50,
"branch_id": null,
"api_id": null,
"query_id": null,
"sort": {
"created_at": "asc"
},
"search": [{
"status": 400
}]
}
```
### Search
Search workspace history allows for granular filtering and sorting of a workspace's API Request History.
Request History is similar to [content search](/xano-features/metadata-api/content#search-and-browse-content), except instead of fields for searching and filtering, request history uses the same options from the Xano dashboard.
* duration - duration of an API request, in seconds.
* status - the status code.
* created\_at - the time of execution, as a timestamp in milliseconds.
#### Examples:
**Search for requests with a duration of less than 2 seconds. Sort by the longest duration.**
In this example, we are searching for requests with a duration less than 2 seconds and sorting the results by duration in descending order.
Example request body:
```json theme={null}
{
"page": 1,
"per_page": 50,
"branch_id": null,
"api_id": null,
"query_id": null,
"sort": {
"duration": "desc"
},
"search": [
{
"duration|<|": 2
}
]
}
```
**Search for Reqeusts with a status code of 400. Sort the Results by oldest.**
Example Request Body:
```json theme={null}
{
"page": 1,
"per_page": 50,
"branch_id": null,
"api_id": null,
"query_id": null,
"sort": {
"created_at": "asc"
},
"search": [{
"status": 400
}]
}
```