---
title: "Retrieve an audit"
method: GET
path: "/audits/{audit_id}"
tags: ["Audits"]
---

# Retrieve an audit

`GET /audits/{audit_id}`

## Request

- Base URL: `http://127.0.0.1:5000/api/v1`
- URL: `http://127.0.0.1:5000/api/v1/audits/{audit_id}`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/clinicalauditai/apis/clinicalauditai-api/docs/audits/:audit_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves an audit belonging to the authenticated client.

Client API keys are tenant-scoped. A client cannot retrieve another
client's audit. A temporary signed PDF URL is generated when a PDF
exists, with a 3600-second expiry.

## Path parameters

- `audit_id` string, uuid, required

## Response `200`

Audit retrieved successfully

- GetAuditResponse
  - `audit_id` string, uuid, required
  - `status` string, required
  - `created_at` string, date-time, required
  - `completed_at` string, date-time, required
  - `result` string, required
  - `pdf_status` string, required
  - `pdf_url` string, uri, nullable, required
  - `pdf_url_expires_in` integer, nullable, required
  - `email_status` 'pending' | 'sent' | 'failed' | 'not_requested', required
  - `webhook_status` 'pending' | 'sent' | 'failed' | 'not_requested', required

## Other responses

- `400`: Invalid audit ID
- `401`: Missing or invalid API key
- `404`: Audit not found or not owned by the authenticated client
- `500`: Server error

---

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