---
title: "Audit log for API key (Build+)"
method: GET
path: "/v1/audit/events"
tags: ["Multi"]
---

# Audit log for API key (Build+)

`GET /v1/audit/events`

## Request

- Base URL: `https://api.playcallerapp.com`
- URL: `https://api.playcallerapp.com/v1/audit/events`
- Auth: API key in header `X-PlayCaller-Key`

Returns a paginated, time-ordered audit trail of key management events (key rotation, IP allowlist changes) and administrative actions associated with your API key. Rolling 90-day retention.

**Tier access:** Build, Growth, Pro Insights, Syndicate Alpha

## Query parameters

- `limit` integer
- `before` string, date-time
- `action` string

## Response `200`

Audit events

- object
  - `success` boolean
  - `count` integer
  - `has_more` boolean
  - `next_cursor` string, date-time, nullable
  - `events` object[]
    - `id` integer
    - `action` string
    - `entity_type` string, nullable
    - `entity_id` string, nullable
    - `metadata` object
    - `ip_address` string, nullable
    - `created_at` string, date-time

## Other responses

- `401`: Missing or invalid API key
- `402`: Build tier or above required
- `429`: Rate limit or monthly quota exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/playcallerapp/apis/playcaller-data-api.md) · [All operations](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/revisions/100c0a3ffbfe?raw)