---
title: "List API audit log entries for the calling tenant"
method: GET
path: "/api-audit-logs"
tags: ["Observability"]
---

# List API audit log entries for the calling tenant

`GET /api-audit-logs`

## Request

- Base URL: `https://app.buildworkpro.com/api/v1`
- URL: `https://app.buildworkpro.com/api/v1/api-audit-logs`
- Auth: HTTP bearer

Returns cursor-paginated API audit log rows for the calling tenant. Each row records one v1 API request — method, path, status, duration, request id, and (when authenticated) the API key id, OAuth token id, or user id that made the call. Filterable by API key, HTTP method, status code, and date range. Tenant-scoped — Tenant A can never see Tenant B's audit log even if scopes are mis-issued.

## Query parameters

- `limit` integer
- `cursor` string
- `apiKeyId` integer
- `method` string
- `status` integer, nullable
- `dateFrom` string, date-time: ISO 8601 lower bound for createdAt (inclusive)
- `dateTo` string, date-time: ISO 8601 upper bound for createdAt (inclusive)

## Response `200`

Audit log page

- object
  - `data` ApiAuditLog[], required
    - `id` integer, required
    - `tenantId` integer, required
    - `apiKeyId` integer, nullable, required
    - `oauthTokenId` integer, nullable, required
    - `userId` integer, nullable, required
    - `method` string, required
    - `path` string, required
    - `status` integer, required
    - `durationMs` integer, required
    - `requestId` string, required
    - `ip` string, nullable, required
    - `userAgent` string, nullable, required
    - `errorCode` string, nullable, required
    - `createdAt` union, required
      - string, date-time
      - string
  - `meta` ResponseMeta, required
    - `request_id` string: Server-generated request identifier
    - `pagination` PaginationMeta
      - `cursor` string, nullable, required: Opaque cursor for the next page; null when no more results
      - `has_more` boolean, required: Whether more pages are available after this one
      - `count` integer, required: Items in this page

## Other responses

- `400`: Bad request
- `403`: Scope insufficient

---

[API](https://skmtc.dev/buildworkpro/apis/buildworkpro-api.md) · [All operations](https://skmtc.dev/buildworkpro/apis/buildworkpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/buildworkpro/apis/buildworkpro-api/revisions/441cf40012f7?raw)