---
title: "GET /orgs/{orgId}/compliance/reports"
method: GET
path: "/orgs/{orgId}/compliance/reports"
---

# GET /orgs/{orgId}/compliance/reports

`GET /orgs/{orgId}/compliance/reports`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/orgs/{orgId}/compliance/reports`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `orgId` string, required: Organization identifier

## Query parameters

- `type` 'SOC2_SUMMARY' | 'ACTIVITY_REPORT' | 'ACCESS_REVIEW' | 'AUDIT_EXPORT' | 'GDPR_DSAR': Filter by report type
- `status` 'PENDING' | 'GENERATING' | 'COMPLETED' | 'FAILED': Filter by status
- `cursor` string: Pagination cursor
- `limit` integer: Maximum number of reports to return

## Response `200`

OK

- object: Paginated list of compliance reports
  - `items` object[], required: List of compliance reports
    - `id` string, required: Unique report identifier
    - `orgId` string, required: Organization identifier
    - `type` 'SOC2_SUMMARY' | 'ACTIVITY_REPORT' | 'ACCESS_REVIEW' | 'AUDIT_EXPORT' | 'GDPR_DSAR', required: Type of compliance report
    - `title` string, required: Report title
    - `description` string, nullable, required: Report description
    - `status` 'PENDING' | 'GENERATING' | 'COMPLETED' | 'FAILED', required: Current status of the report
    - `format` 'JSON' | 'CSV' | 'PDF', required: Export format for the report
    - `parameters` object, required: Report generation parameters
    - `content` object, nullable, required: Report content data
    - `errorMessage` string, nullable, required: Error message if report generation failed
    - `generatedBy` string, nullable, required: User who generated the report
    - `periodStart` string, nullable, required: ISO 8601 report period start
    - `periodEnd` string, nullable, required: ISO 8601 report period end
    - `completedAt` string, nullable, required: ISO 8601 completion timestamp
    - `createdAt` string, required: ISO 8601 creation timestamp
    - `updatedAt` string, required: ISO 8601 last update timestamp
  - `nextCursor` string, nullable, required: Cursor for the next page, null if no more results

---

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