# Get audit by ID

Return one audit by id: a list row plus `product`, the product the audit is
scoped to when the framework is certified per product (null otherwise).
Use it to follow up on a specific audit after `get_audits`, or to resolve the
`auditId` on a control.

Endpoint: GET /v1/audits/{id}
Version: 0.1.0
Security: BearerAuth

## Security:

  - `BearerAuth` (unknown)
    http bearer JWT

## Path parameters:

  - `id` (string, required)
    The audit's id, as returned by get_audits.

## Response 200:

  - `200` (unknown)
    Successful Response

## Response 200 fields (application/json):

  - `id` (string, required)
    Stable identifier.

  - `framework` (any)
    The framework being audited.

  - `framework.id` (string, required)
    Framework id.

  - `framework.name` (string, required)
    Framework display name, e.g. 'SOC 2 Type II'.

  - `status` (string, required)
    Where an audit is in its lifecycle. Stored by the product; served as snake_case.
    Enum: "active", "not_active", "completed"

  - `startDate` (any)
    Start of the audit period; null when not set.

  - `endDate` (any)
    End of the audit period; null when not set.

  - `createdAt` (any)
    When the audit was created.

  - `updatedAt` (any)
    Last change to the audit.

  - `product` (any)
    The product audited; null when not per-product.

  - `product.id` (string, required)
    Product id.

  - `product.name` (string, required)
    Product display name.

## Response 400:

  - `400` (unknown)
    Invalid or unknown parameter, page size or cursor.

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.code` (string, required)

  - `error.message` (string, required)

## Response 401:

  - `401` (unknown)
    Missing or invalid credentials.

## Response 401 fields (application/json):

  - `error` (object, required)

  - `error.code` (string, required)

  - `error.message` (string, required)

## Response 404:

  - `404` (unknown)
    No such audit for this company.

## Response 404 fields (application/json):

  - `error` (object, required)

  - `error.code` (string, required)

  - `error.message` (string, required)

## Response 503:

  - `503` (unknown)
    Data is temporarily unavailable.

## Response 503 fields (application/json):

  - `error` (object, required)

  - `error.code` (string, required)

  - `error.message` (string, required)