# Get Audits

Endpoint: GET /
Version: 1.0
Security: oauth2

## Query parameters:

  - `status` (string)
    Filters audits by status. Supported values: active, archived. When omitted, both active and archived audits are returned
    Enum: "active", "archived"

## Response 200 fields (application/json):

  - `id` (string, required)
    The unique identifier for the audit
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `name` (string, required)
    Name of the audit
    Example: "Q4 2024 SOC2 Audit"

  - `description` (string,null)
    Description of the audit
    Example: "Quarterly audit for SOC2 compliance requirements"

  - `auditType` (string, required)
    The type of the audit.
    Enum: "documentRequestList"

  - `status` (string, required)
    The status of the object.
    Enum: "active", "archived", "pending", "canceled", "deleted", "closed"

  - `workStatus` (string, required)
    The work status of a parent object (e.g. audit, assessment)
    Enum: "active", "completed"

  - `primaryContact` (string, required)
    The unique identifier of the user listed as the primary contact for the audit
    Example: "a7b8c9d0-e1f2-3456-abcd-ef1234567890"

  - `clonedAuditId` (string,null)
    The unique identifier of the audit this was cloned from, if applicable

  - `orgId` (string, required)
    The unique identifier of the organization the audit belongs to
    Example: "ce83e3cd-5199-11ee-a644-522476618ae8"

  - `createdBy` (string, required)
    The unique identifier of the user who created the audit
    Example: "a7b8c9d0-e1f2-3456-abcd-ef1234567890"

  - `createdOn` (string, required)
    The date the audit was created (ISO-8601 format)
    Example: "2024-10-01T08:00:00Z"

  - `updatedBy` (string, required)
    The unique identifier of the user who last updated the audit
    Example: "a7b8c9d0-e1f2-3456-abcd-ef1234567890"

  - `updatedOn` (string, required)
    The date the audit was last updated (ISO-8601 format)
    Example: "2024-10-15T14:30:00Z"

  - `permissions` (array,null)
    List of permissions the API user has on the audit
    Example: []


## Response 400 fields

## Response 401 fields

## Response 403 fields