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

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

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

## Request

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

## Path parameters

- `orgId` string, required: Organization identifier
- `controlId` string, required: Compliance control identifier

## Query parameters

- `type` 'AUTOMATED' | 'MANUAL' | 'SCREENSHOT' | 'DOCUMENT': Filter by evidence type
- `source` 'GITHUB' | 'AWS' | 'CLERK' | 'INTERNAL' | 'MANUAL': Filter by evidence source
- `cursor` string: Pagination cursor
- `limit` integer: Maximum number of items to return

## Response `200`

OK

- object: Paginated list of evidence items
  - `items` object[], required: List of evidence items
    - `id` string, required: Unique evidence item identifier
    - `controlId` string, required: Associated compliance control identifier
    - `type` 'AUTOMATED' | 'MANUAL' | 'SCREENSHOT' | 'DOCUMENT', required: Type of evidence item
    - `source` 'GITHUB' | 'AWS' | 'CLERK' | 'INTERNAL' | 'MANUAL', required: Source of the evidence
    - `title` string, required: Evidence title
    - `description` string, nullable, required: Evidence description
    - `content` object, required: Structured evidence content
    - `url` string, nullable, required: URL reference for external evidence
    - `collectedAt` string, required: ISO 8601 collection timestamp
    - `expiresAt` string, nullable, required: ISO 8601 expiration timestamp
    - `createdAt` string, required: ISO 8601 creation 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)
