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

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

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

## Request

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

## Path parameters

- `orgId` string, required: Organization identifier

## Query parameters

- `framework` 'SOC2' | 'GDPR' | 'PCI': Filter by framework
- `category` 'CC1' | 'CC2' | 'CC3' | 'CC4' | 'CC5' | 'CC6' | 'CC7' | 'CC8' | 'CC9' | 'A1' | 'PI1' | 'C1' | 'P1': Filter by category
- `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'IMPLEMENTED' | 'VERIFIED' | 'FAILED': Filter by status
- `cursor` string: Pagination cursor
- `limit` integer: Maximum number of controls to return

## Response `200`

OK

- object: Paginated list of compliance controls
  - `items` object[], required: List of compliance controls
    - `id` string, required: Unique control identifier
    - `orgId` string, required: Organization identifier
    - `framework` 'SOC2' | 'GDPR' | 'PCI', required: Compliance framework identifier
    - `controlId` string, required: Control identifier (e.g. CC1.1)
    - `title` string, required: Control title
    - `description` string, required: Control description
    - `category` 'CC1' | 'CC2' | 'CC3' | 'CC4' | 'CC5' | 'CC6' | 'CC7' | 'CC8' | 'CC9' | 'A1' | 'PI1' | 'C1' | 'P1', required: Trust Service Criteria category
    - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'IMPLEMENTED' | 'VERIFIED' | 'FAILED', required: Current status of the compliance control
    - `owner` string, nullable, required: Owner responsible for this control
    - `lastTestedAt` string, nullable, required: ISO 8601 timestamp of last test
    - `nextReviewAt` string, nullable, required: ISO 8601 timestamp of next review
    - `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)