---
title: "List team audit log REST API | HitKeep"
description: "Reference for the HitKeep REST API operation List team audit log, including request parameters, responses, and authentication notes."
canonical: "https://hitkeep.com/api/operations/apiuserteamsidaudit/"
---

# List team audit log REST API

GET

/api/user/teams/{id}/audit

FetchcURL

```
const url = 'http://127.0.0.1:25737/api/user/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/audit';
const options = {method: 'GET', headers: {cookie: 'hk_token=<hk_token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```
curl --request GET \
  --url http://127.0.0.1:25737/api/user/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/audit \
  --cookie hk_token=<hk_token>
```

-

Lists recent audit events for team management actions.

## Authorizations

- **[cookieAuth](https://hitkeep.com/api/#cookieauth)**

## Parameters

### Path Parameters

**id**

required

string format: uuid

### Query Parameters

**action**

string

Optional exact audit action to filter by.

**outcome**

string

Optional exact audit outcome to filter by.

**target_type**

string

Optional exact audit target type to filter by.

**query**

string

Searches actor, target, details, IP, country, and request ID fields.

**from**

string format: date-time

Inclusive RFC3339 start timestamp.

**to**

string format: date-time

Inclusive RFC3339 end timestamp.

**limit**

integer

>= 1 <= 200

Maximum number of audit rows to return (default 25, max 200).

**offset**

integer

Zero-based audit row offset for pagination.

## Responses

### 200

Team audit entries

application/json

object

**action**

string

**entries**

Array<object>

object

**action**

string

**actor_email**

string format: email

**actor_email_snapshot**

string

**actor_role_snapshot**

string

**actor_user_id**

string format: uuid

**created_at**

string format: date-time

**details**

string

**id**

string format: uuid

**ip_address**

string

**ip_country_code**

string

**outcome**

string

**request_id**

string

**target_email**

string format: email

**target_id**

string

**target_label**

string

**target_type**

string

**target_user_id**

string format: uuid

**team_id**

string format: uuid

**user_agent**

string

**has_more**

boolean

**limit**

integer

**offset**

integer

**total**

integer

##### Examplegenerated

```
{
  "action": "example",
  "entries": [
    {
      "action": "example",
      "actor_email": "hello@example.com",
      "actor_email_snapshot": "example",
      "actor_role_snapshot": "example",
      "actor_user_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "created_at": "2026-04-15T12:00:00Z",
      "details": "example",
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "ip_address": "example",
      "ip_country_code": "example",
      "outcome": "example",
      "request_id": "example",
      "target_email": "hello@example.com",
      "target_id": "example",
      "target_label": "example",
      "target_type": "example",
      "target_user_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "team_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "user_agent": "example"
    }
  ],
  "has_more": true,
  "limit": 1,
  "offset": 1,
  "total": 1
}
```

### 400

Invalid query parameters

application/json

object

**message**

string

##### Examplegenerated

```
{
  "message": "example"
}
```

### 403

Access denied

application/json

object

**message**

string

##### Examplegenerated

```
{
  "message": "example"
}
```

[Previous Archive team](https://hitkeep.com/api/operations/apiuserteamsidarchive/)[Next List team traffic exclusions](https://hitkeep.com/api/operations/apiuserteamsidexclusions/get/)