---
title: "Get a beacon audit"
method: GET
path: "/v1/beacon/audits/{auditId}"
tags: ["beacon"]
---

# Get a beacon audit

`GET /v1/beacon/audits/{auditId}`

Get a beacon audit by ID, including the report if completed

## Path parameters

- `auditId` string, required — The ID of the audit

## Response `200`

The audit details

- object
  - `id` string, required
  - `targetUrl` string, required
  - `status` 'pending' | 'partial' | 'completed' | 'failed', required
  - `durationMs` number, nullable, required
  - `createdAt` string, date-time, required
  - `report` object, nullable, required
    - `schemaVersion` string, required
    - `auditId` string, required
    - `targetUrl` string, required
    - `startedAt` string, required
    - `completedAt` string, required
    - `durationMs` number, required
    - `results` object[], required
      - `checkId` string, required
      - `checkName` string, required
      - `description` string, required
      - `status` 'pass' | 'fail' | 'skip' | 'pending', required
      - `message` string, required
      - `skipReason` string
      - `severity` 'error' | 'warning' | 'info', required
      - `category` 'connectivity' | 'tool-metadata' | 'resource-metadata' | 'performance' | 'e2e', required
      - `scope` 'server' | 'view', required
      - `platforms` string[]
      - `durationMs` number, required
      - `details` object[]
        - `label` string, required
        - `value` string
      - `hint` object
        - `text` string, required
    - `requiresAuth` boolean, required
    - `hasViewSupport` boolean, required
    - `viewPlatforms` string[]
    - `isReadyForPlatform` object, required
    - `widgetScreenshotKeys` object, required
      - `chatgpt` string
      - `claudeai` string
    - `widgetScreenshots` object, required
      - `chatgpt` object
        - `url` string, required
      - `claudeai` object
        - `url` string, required

## Other responses

- `400` — 400
- `404` — 404

## Changes

- **2026-08-11** `605de0884cc9` — 1 info
  - added the non-success response with the status `400`

[Change history](https://skmtc.dev/alpic/apis/alpic-api/changes/v1/beacon/audits/:auditId/get.md)

---

[API](https://skmtc.dev/alpic/apis/alpic-api.md) · [All operations](https://skmtc.dev/alpic/apis/alpic-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alpic/alpic-api/revisions/262875478562/schema)