---
title: "List commitment evidence"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.sureshake.com/llms.txt
> Use this file to discover all available pages before exploring further.

Path: Sureshake API › execution

`GET /v2/execution/cycles/{cycleId}/commitments/{commitmentId}/evidence`

## Path parameters

- `cycleId` (`execution-list-commitment-evidence.path.cycleId`; string, required)
  - format `uuid`
- `commitmentId` (`execution-list-commitment-evidence.path.commitmentId`; string, required)
  - format `uuid`

## Code samples

### cURL

```bash
curl --request GET \
  --url 'https://api.sureshake.com/v2/execution/cycles/<cycleId>/commitments/<commitmentId>/evidence'
```

### TypeScript

```typescript
const url = 'https://api.sureshake.com/v2/execution/cycles/<cycleId>/commitments/<commitmentId>/evidence';
const options = {method: 'GET'};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.sureshake.com/v2/execution/cycles/<cycleId>/commitments/<commitmentId>/evidence"

response = requests.get(url)

print(response.text)
```

## Responses

### 200

Default Response

#### Example

```json
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "commitmentId": "4e1ecf7c-8127-4207-92b0-010ff43ff54d",
      "commitmentVersionNumber": 1,
      "resolutionId": "bc6d8f79-6014-4352-9db6-903e2ea5d245",
      "displayName": "string",
      "ownerEntityId": "6da7bd98-1f0e-4b09-9a16-e8663f1e0b04",
      "effectiveAt": "2019-08-24T14:15:22Z",
      "visibility": "public",
      "recordedBy": "string",
      "sourceHash": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "sourceKind": "upload",
      "verificationStatus": "artifact_backed",
      "artifactId": "706a3f1e-c357-4634-b1bf-20c221b5bb4e",
      "reference": {
        "type": "page",
        "page": 1,
        "pageEnd": 1
      },
      "invitation": null
    }
  ],
  "meta": {
    "total": 0,
    "limit": 0,
    "offset": 0,
    "hasMore": true,
    "page": 0,
    "totalPages": 0
  },
  "evidenceStatus": {
    "state": "missing",
    "commitmentVersionNumber": 1,
    "evidenceCount": 0,
    "basis": "persisted_evidence_records"
  }
}
```

- `data` (`execution-list-commitment-evidence.response.200.data`; array<any of>, required)
  - any of:
    - `object`
      - `id` (`execution-list-commitment-evidence.response.200.data.1.id`; string, required)
        - format `uuid`
      - `commitmentId` (`execution-list-commitment-evidence.response.200.data.1.commitmentId`; string, required)
        - format `uuid`
      - `commitmentVersionNumber` (`execution-list-commitment-evidence.response.200.data.1.commitmentVersionNumber`; integer, required)
        - min 1
      - `resolutionId` (`execution-list-commitment-evidence.response.200.data.1.resolutionId`; string, required, nullable)
        - format `uuid`
      - `displayName` (`execution-list-commitment-evidence.response.200.data.1.displayName`; string, required)
        - minLength 1; maxLength 500
      - `ownerEntityId` (`execution-list-commitment-evidence.response.200.data.1.ownerEntityId`; string, required)
        - format `uuid`
      - `effectiveAt` (`execution-list-commitment-evidence.response.200.data.1.effectiveAt`; string, required)
        - format `date-time`
      - `visibility` (`execution-list-commitment-evidence.response.200.data.1.visibility`; string, required)
        - one of `"public"`, `"follower"`, `"capital"`, `"diligence"`, `"custom"`
      - `recordedBy` (`execution-list-commitment-evidence.response.200.data.1.recordedBy`; string, required)
        - minLength 1
      - `sourceHash` (`execution-list-commitment-evidence.response.200.data.1.sourceHash`; string, required)
        - pattern `^sha256:[a-f0-9]{64}$`
      - `createdAt` (`execution-list-commitment-evidence.response.200.data.1.createdAt`; string, required)
        - format `date-time`
      - `sourceKind` (`execution-list-commitment-evidence.response.200.data.1.sourceKind`; string, required)
        - one of `"upload"`
      - `verificationStatus` (`execution-list-commitment-evidence.response.200.data.1.verificationStatus`; string, required)
        - one of `"artifact_backed"`
      - `artifactId` (`execution-list-commitment-evidence.response.200.data.1.artifactId`; string, required)
        - format `uuid`
      - `reference` (`execution-list-commitment-evidence.response.200.data.1.reference`; any of, optional)
        - any of:
          - `object`
            - `type` (`execution-list-commitment-evidence.response.200.data.1.reference.1.type`; string, required)
              - one of `"page"`
            - `page` (`execution-list-commitment-evidence.response.200.data.1.reference.1.page`; integer, required)
              - min 1
            - `pageEnd` (`execution-list-commitment-evidence.response.200.data.1.reference.1.pageEnd`; integer, optional)
              - min 1
          - `object`
            - `type` (`execution-list-commitment-evidence.response.200.data.1.reference.2.type`; string, required)
              - one of `"section"`
            - `section` (`execution-list-commitment-evidence.response.200.data.1.reference.2.section`; string, required)
              - minLength 1; maxLength 500
          - `object`
            - `type` (`execution-list-commitment-evidence.response.200.data.1.reference.3.type`; string, required)
              - one of `"object"`
            - `objectType` (`execution-list-commitment-evidence.response.200.data.1.reference.3.objectType`; string, required)
              - minLength 1; maxLength 200
            - `objectId` (`execution-list-commitment-evidence.response.200.data.1.reference.3.objectId`; string, required)
              - minLength 1; maxLength 1000
      - `invitation` (`execution-list-commitment-evidence.response.200.data.1.invitation`; unknown, optional)
    - `object`
      - `id` (`execution-list-commitment-evidence.response.200.data.2.id`; string, required)
        - format `uuid`
      - `commitmentId` (`execution-list-commitment-evidence.response.200.data.2.commitmentId`; string, required)
        - format `uuid`
      - `commitmentVersionNumber` (`execution-list-commitment-evidence.response.200.data.2.commitmentVersionNumber`; integer, required)
        - min 1
      - `resolutionId` (`execution-list-commitment-evidence.response.200.data.2.resolutionId`; string, required, nullable)
        - format `uuid`
      - `displayName` (`execution-list-commitment-evidence.response.200.data.2.displayName`; string, required)
        - minLength 1; maxLength 500
      - `ownerEntityId` (`execution-list-commitment-evidence.response.200.data.2.ownerEntityId`; string, required)
        - format `uuid`
      - `effectiveAt` (`execution-list-commitment-evidence.response.200.data.2.effectiveAt`; string, required)
        - format `date-time`
      - `visibility` (`execution-list-commitment-evidence.response.200.data.2.visibility`; string, required)
        - one of `"public"`, `"follower"`, `"capital"`, `"diligence"`, `"custom"`
      - `recordedBy` (`execution-list-commitment-evidence.response.200.data.2.recordedBy`; string, required)
        - minLength 1
      - `sourceHash` (`execution-list-commitment-evidence.response.200.data.2.sourceHash`; string, required)
        - pattern `^sha256:[a-f0-9]{64}$`
      - `createdAt` (`execution-list-commitment-evidence.response.200.data.2.createdAt`; string, required)
        - format `date-time`
      - `sourceKind` (`execution-list-commitment-evidence.response.200.data.2.sourceKind`; string, required)
        - one of `"sureshake_link"`
      - `verificationStatus` (`execution-list-commitment-evidence.response.200.data.2.verificationStatus`; string, required)
        - one of `"artifact_backed"`
      - `resourceType` (`execution-list-commitment-evidence.response.200.data.2.resourceType`; string, required)
        - one of `"report"`, `"artifact"`
      - `resourceId` (`execution-list-commitment-evidence.response.200.data.2.resourceId`; string, required)
        - format `uuid`
      - `reference` (`execution-list-commitment-evidence.response.200.data.2.reference`; unknown, optional)
      - `invitation` (`execution-list-commitment-evidence.response.200.data.2.invitation`; unknown, optional)
    - `object`
      - `id` (`execution-list-commitment-evidence.response.200.data.3.id`; string, required)
        - format `uuid`
      - `commitmentId` (`execution-list-commitment-evidence.response.200.data.3.commitmentId`; string, required)
        - format `uuid`
      - `commitmentVersionNumber` (`execution-list-commitment-evidence.response.200.data.3.commitmentVersionNumber`; integer, required)
        - min 1
      - `resolutionId` (`execution-list-commitment-evidence.response.200.data.3.resolutionId`; string, required, nullable)
        - format `uuid`
      - `displayName` (`execution-list-commitment-evidence.response.200.data.3.displayName`; string, required)
        - minLength 1; maxLength 500
      - `ownerEntityId` (`execution-list-commitment-evidence.response.200.data.3.ownerEntityId`; string, required)
        - format `uuid`
      - `effectiveAt` (`execution-list-commitment-evidence.response.200.data.3.effectiveAt`; string, required)
        - format `date-time`
      - `visibility` (`execution-list-commitment-evidence.response.200.data.3.visibility`; string, required)
        - one of `"public"`, `"follower"`, `"capital"`, `"diligence"`, `"custom"`
      - `recordedBy` (`execution-list-commitment-evidence.response.200.data.3.recordedBy`; string, required)
        - minLength 1
      - `sourceHash` (`execution-list-commitment-evidence.response.200.data.3.sourceHash`; string, required)
        - pattern `^sha256:[a-f0-9]{64}$`
      - `createdAt` (`execution-list-commitment-evidence.response.200.data.3.createdAt`; string, required)
        - format `date-time`
      - `sourceKind` (`execution-list-commitment-evidence.response.200.data.3.sourceKind`; string, required)
        - one of `"integration"`
      - `verificationStatus` (`execution-list-commitment-evidence.response.200.data.3.verificationStatus`; string, required)
        - one of `"source_verified"`
      - `integrationId` (`execution-list-commitment-evidence.response.200.data.3.integrationId`; string, required)
        - format `uuid`
      - `integrationKey` (`execution-list-commitment-evidence.response.200.data.3.integrationKey`; string, required)
        - minLength 1
      - `resourceType` (`execution-list-commitment-evidence.response.200.data.3.resourceType`; string, required)
        - minLength 1; maxLength 200
      - `externalId` (`execution-list-commitment-evidence.response.200.data.3.externalId`; string, required)
        - minLength 1; maxLength 1000
      - `contentHash` (`execution-list-commitment-evidence.response.200.data.3.contentHash`; string, required)
        - pattern `^sha256:[a-f0-9]{64}$`
      - `retrievedAt` (`execution-list-commitment-evidence.response.200.data.3.retrievedAt`; string, required)
        - format `date-time`
      - `reference` (`execution-list-commitment-evidence.response.200.data.3.reference`; unknown, optional)
      - `invitation` (`execution-list-commitment-evidence.response.200.data.3.invitation`; unknown, optional)
    - `object`
      - `id` (`execution-list-commitment-evidence.response.200.data.4.id`; string, required)
        - format `uuid`
      - `commitmentId` (`execution-list-commitment-evidence.response.200.data.4.commitmentId`; string, required)
        - format `uuid`
      - `commitmentVersionNumber` (`execution-list-commitment-evidence.response.200.data.4.commitmentVersionNumber`; integer, required)
        - min 1
      - `resolutionId` (`execution-list-commitment-evidence.response.200.data.4.resolutionId`; string, required, nullable)
        - format `uuid`
      - `displayName` (`execution-list-commitment-evidence.response.200.data.4.displayName`; string, required)
        - minLength 1; maxLength 500
      - `ownerEntityId` (`execution-list-commitment-evidence.response.200.data.4.ownerEntityId`; string, required)
        - format `uuid`
      - `effectiveAt` (`execution-list-commitment-evidence.response.200.data.4.effectiveAt`; string, required)
        - format `date-time`
      - `visibility` (`execution-list-commitment-evidence.response.200.data.4.visibility`; string, required)
        - one of `"public"`, `"follower"`, `"capital"`, `"diligence"`, `"custom"`
      - `recordedBy` (`execution-list-commitment-evidence.response.200.data.4.recordedBy`; string, required)
        - minLength 1
      - `sourceHash` (`execution-list-commitment-evidence.response.200.data.4.sourceHash`; string, required)
        - pattern `^sha256:[a-f0-9]{64}$`
      - `createdAt` (`execution-list-commitment-evidence.response.200.data.4.createdAt`; string, required)
        - format `date-time`
      - `sourceKind` (`execution-list-commitment-evidence.response.200.data.4.sourceKind`; string, required)
        - one of `"third_party_attestation"`
      - `verificationStatus` (`execution-list-commitment-evidence.response.200.data.4.verificationStatus`; string, required)
        - one of `"third_party_attested"`
      - `attestorUserId` (`execution-list-commitment-evidence.response.200.data.4.attestorUserId`; string, required)
        - minLength 1
      - `attestationScope` (`execution-list-commitment-evidence.response.200.data.4.attestationScope`; any of, required)
        - any of:
          - `object`
            - `status` (`execution-list-commitment-evidence.response.200.data.4.attestationScope.1.status`; string, required)
              - one of `"complete"`
            - `observed` (`execution-list-commitment-evidence.response.200.data.4.attestationScope.1.observed`; string, required)
              - minLength 1; maxLength 4000
            - `notVerified` (`execution-list-commitment-evidence.response.200.data.4.attestationScope.1.notVerified`; string, required)
              - minLength 1; maxLength 4000
          - `object`
            - `status` (`execution-list-commitment-evidence.response.200.data.4.attestationScope.2.status`; string, required)
              - one of `"legacy_incomplete"`
            - `legacyStatement` (`execution-list-commitment-evidence.response.200.data.4.attestationScope.2.legacyStatement`; string, required)
              - minLength 1; maxLength 4000
      - `reference` (`execution-list-commitment-evidence.response.200.data.4.reference`; unknown, optional)
      - `invitation` (`execution-list-commitment-evidence.response.200.data.4.invitation`; object, optional)
        - `id` (`execution-list-commitment-evidence.response.200.data.4.invitation.id`; string, required)
          - format `uuid`
        - `relationship` (`execution-list-commitment-evidence.response.200.data.4.invitation.relationship`; string, required)
          - one of `"customer"`, `"mentor"`, `"advisor"`, `"program_operator"`, `"capital_provider"`
- `meta` (`execution-list-commitment-evidence.response.200.meta`; object, required)
  - `total` (`execution-list-commitment-evidence.response.200.meta.total`; number, required) — Total number of items available
  - `limit` (`execution-list-commitment-evidence.response.200.meta.limit`; number, required) — Number of items per page
  - `offset` (`execution-list-commitment-evidence.response.200.meta.offset`; number, required) — Number of items skipped
  - `hasMore` (`execution-list-commitment-evidence.response.200.meta.hasMore`; boolean, required) — Whether more items are available
  - `page` (`execution-list-commitment-evidence.response.200.meta.page`; number, optional) — Current page number
  - `totalPages` (`execution-list-commitment-evidence.response.200.meta.totalPages`; number, optional) — Total number of pages
- `evidenceStatus` (`execution-list-commitment-evidence.response.200.evidenceStatus`; any of, required)
  - any of:
    - `object`
      - `state` (`execution-list-commitment-evidence.response.200.evidenceStatus.1.state`; string, required)
        - one of `"missing"`
      - `commitmentVersionNumber` (`execution-list-commitment-evidence.response.200.evidenceStatus.1.commitmentVersionNumber`; integer, required)
        - min 1
      - `evidenceCount` (`execution-list-commitment-evidence.response.200.evidenceStatus.1.evidenceCount`; number, required)
        - one of `0`
      - `basis` (`execution-list-commitment-evidence.response.200.evidenceStatus.1.basis`; string, required)
        - one of `"persisted_evidence_records"`
    - `object`
      - `state` (`execution-list-commitment-evidence.response.200.evidenceStatus.2.state`; string, required)
        - one of `"present"`
      - `commitmentVersionNumber` (`execution-list-commitment-evidence.response.200.evidenceStatus.2.commitmentVersionNumber`; integer, required)
        - min 1
      - `evidenceCount` (`execution-list-commitment-evidence.response.200.evidenceStatus.2.evidenceCount`; integer, required)
        - min 1
      - `basis` (`execution-list-commitment-evidence.response.200.evidenceStatus.2.basis`; string, required)
        - one of `"persisted_evidence_records"`

### 400

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`execution-list-commitment-evidence.response.400.error`; object, required)
  - `code` (`execution-list-commitment-evidence.response.400.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`execution-list-commitment-evidence.response.400.error.message`; string, required) — Human-readable error message
  - `details` (`execution-list-commitment-evidence.response.400.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`execution-list-commitment-evidence.response.400.error.traceId`; string, optional) — Unique ID for log correlation

### 401

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`execution-list-commitment-evidence.response.401.error`; object, required)
  - `code` (`execution-list-commitment-evidence.response.401.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`execution-list-commitment-evidence.response.401.error.message`; string, required) — Human-readable error message
  - `details` (`execution-list-commitment-evidence.response.401.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`execution-list-commitment-evidence.response.401.error.traceId`; string, optional) — Unique ID for log correlation

### 403

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`execution-list-commitment-evidence.response.403.error`; object, required)
  - `code` (`execution-list-commitment-evidence.response.403.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`execution-list-commitment-evidence.response.403.error.message`; string, required) — Human-readable error message
  - `details` (`execution-list-commitment-evidence.response.403.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`execution-list-commitment-evidence.response.403.error.traceId`; string, optional) — Unique ID for log correlation

### 404

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`execution-list-commitment-evidence.response.404.error`; object, required)
  - `code` (`execution-list-commitment-evidence.response.404.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`execution-list-commitment-evidence.response.404.error.message`; string, required) — Human-readable error message
  - `details` (`execution-list-commitment-evidence.response.404.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`execution-list-commitment-evidence.response.404.error.traceId`; string, optional) — Unique ID for log correlation

### 409

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`execution-list-commitment-evidence.response.409.error`; object, required)
  - `code` (`execution-list-commitment-evidence.response.409.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`execution-list-commitment-evidence.response.409.error.message`; string, required) — Human-readable error message
  - `details` (`execution-list-commitment-evidence.response.409.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`execution-list-commitment-evidence.response.409.error.traceId`; string, optional) — Unique ID for log correlation

### 422

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`execution-list-commitment-evidence.response.422.error`; object, required)
  - `code` (`execution-list-commitment-evidence.response.422.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`execution-list-commitment-evidence.response.422.error.message`; string, required) — Human-readable error message
  - `details` (`execution-list-commitment-evidence.response.422.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`execution-list-commitment-evidence.response.422.error.traceId`; string, optional) — Unique ID for log correlation

### 429

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`execution-list-commitment-evidence.response.429.error`; object, required)
  - `code` (`execution-list-commitment-evidence.response.429.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`execution-list-commitment-evidence.response.429.error.message`; string, required) — Human-readable error message
  - `details` (`execution-list-commitment-evidence.response.429.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`execution-list-commitment-evidence.response.429.error.traceId`; string, optional) — Unique ID for log correlation

### 500

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`execution-list-commitment-evidence.response.500.error`; object, required)
  - `code` (`execution-list-commitment-evidence.response.500.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`execution-list-commitment-evidence.response.500.error.message`; string, required) — Human-readable error message
  - `details` (`execution-list-commitment-evidence.response.500.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`execution-list-commitment-evidence.response.500.error.traceId`; string, optional) — Unique ID for log correlation

### 502

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`execution-list-commitment-evidence.response.502.error`; object, required)
  - `code` (`execution-list-commitment-evidence.response.502.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`execution-list-commitment-evidence.response.502.error.message`; string, required) — Human-readable error message
  - `details` (`execution-list-commitment-evidence.response.502.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`execution-list-commitment-evidence.response.502.error.traceId`; string, optional) — Unique ID for log correlation

### 503

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`execution-list-commitment-evidence.response.503.error`; object, required)
  - `code` (`execution-list-commitment-evidence.response.503.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`execution-list-commitment-evidence.response.503.error.message`; string, required) — Human-readable error message
  - `details` (`execution-list-commitment-evidence.response.503.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`execution-list-commitment-evidence.response.503.error.traceId`; string, optional) — Unique ID for log correlation


Source: https://docs.sureshake.com/reference/execution-list-commitment-evidence/index.md
