---
title: "Get audit logs belonging to the tenant."
method: GET
path: "/network-services/v1/audits"
tags: ["Audit Trail Information"]
---

# Get audit logs belonging to the tenant.

`GET /network-services/v1/audits`

This API retrieves all the audit logs based on the tenants.

## Query parameters

- `start-at` string, date-time, required — Date-time in RFC 3339 format (ISO 8601) in UTC timezone with milliseconds.
- `end-at` string, date-time, required — Date-time in RFC 3339 format (ISO 8601) in UTC timezone with milliseconds.
- `filter` string
- `sort` string
- `limit` integer
- `offset` integer

## Response `200`

Successful operation

- AuditListResponse — Get audit List belonging to the tenant.
  - `items` AuditDetailResponse[], required
    - `id` string, uuid, required — Unique identifier of the resource.
    - `type` string, required — Resource type.
    - `generation` integer, required — Monotonically increasing update counter.
    - `createdAt` string, date-time, required — RFC 3339 UTC timestamp when the resource was created.
    - `updatedAt` string, date-time, required — RFC 3339 UTC timestamp when the resource was last updated.
    - `auditId` string, required — The audit id of audit.
    - `category` string, required — Category of the executed action.
    - `occurredOn` string, required — RFC 3339 UTC timestamp of when the operation executed.
    - `description` string, required — Description of the executed action
    - `ipAddress` string, required — Source IP Address of the user executed the operation.
    - `action` string, required — Brief text specifying the executed operation.
    - `source` string, required — Email ID of the user executed the operation.
    - `subCategory` string, required — Sub-category of the executed action.
    - `destinationName` string, required — The serial number or Host Name of the audit.
    - `destination` string, required — Name of the entity/component on which action has been performed.
  - `count` integer, required — Number of objects returned in the list. Maximum will be page size.
  - `total` integer — The total number of objects contained in the datastore.
  - `offset` integer, required — Number of items skipped before the returned results.

## Other responses

- `400` — Invalid input received.
- `401` — Unauthorized. Authentication credentials are required or invalid.
- `403` — Forbidden: Access is denied.
- `404` — Resource not found error response.
- `429` — Too Many Requests. The user has sent too many requests in a given amount of time.
- `500` — Internal Server Error. An unexpected error occurred on the server.

---

[API](https://skmtc.net/arubanetworks/apis/authorization.md) · [All operations](https://skmtc.net/arubanetworks/apis/authorization/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arubanetworks/authorization/revisions/74c95058b11f/schema)