---
title: "Get audit records"
method: GET
path: "/rest/api/2/auditing/record"
tags: ["Audit records"]
---

# Get audit records

`GET /rest/api/2/auditing/record`

Returns a list of audit records. The list can be filtered to include items:

 *  where each item in `filter` has at least one match in any of these fields:
    
     *  `summary`
     *  `category`
     *  `eventSource`
     *  `objectItem.name` If the object is a user, account ID is available to filter.
     *  `objectItem.parentName`
     *  `objectItem.typeName`
     *  `changedValues.changedFrom`
     *  `changedValues.changedTo`
     *  `remoteAddress`
    
    For example, if `filter` contains *man ed*, an audit record containing `summary": "User added to group"` and `"category": "group management"` is returned.
 *  created on or after a date and time.
 *  created or or before a date and time.

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Query parameters

- `offset` integer
- `limit` integer
- `filter` string
- `from` string
- `to` string

## Response `200`

Returned if the request is successful.

- AuditRecords — Container for a list of audit records.
  - `limit` integer — The requested or default limit on the number of audit items to be returned.
  - `offset` integer — The number of audit items skipped before the first item in this list.
  - `records` AuditRecordBean[] — The list of audit items.
    - `associatedItems` AssociatedItemBean[] — The list of items associated with the changed record.
      - `id` string — The ID of the associated record.
      - `name` string — The name of the associated record.
      - `parentId` string — The ID of the associated parent record.
      - `parentName` string — The name of the associated parent record.
      - `typeName` string — The type of the associated record.
    - `authorKey` string — Deprecated, use `authorAccountId` instead. The key of the user who created the audit record.
    - `category` string — The category of the audit record. For a list of these categories, see the help article [Auditing in Jira applications](https://confluence.atlassian.com/x/noXKM).
    - `changedValues` ChangedValueBean[] — The list of values changed in the record event.
      - `changedFrom` string — The value of the field before the change.
      - `changedTo` string — The value of the field after the change.
      - `fieldName` string — The name of the field changed.
    - `created` string, date-time — The date and time on which the audit record was created.
    - `description` string — The description of the audit record.
    - `eventSource` string — The event the audit record originated from.
    - `id` integer — The ID of the audit record.
    - `objectItem` AssociatedItemBean — Details of an item associated with the changed record.
      - `id` string — The ID of the associated record.
      - `name` string — The name of the associated record.
      - `parentId` string — The ID of the associated parent record.
      - `parentName` string — The name of the associated parent record.
      - `typeName` string — The type of the associated record.
    - `remoteAddress` string — The URL of the computer where the creation of the audit record was initiated.
    - `summary` string — The summary of the audit record.
  - `total` integer — The total number of audit items returned.

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if: * the user does not have the required permissions. * all Jira products are on free plans. Audit logs are available when at least one Jira product is on a paid plan.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api/versions/a26541c2f8bd/schema)