---
title: "Get Evidence Task Implementation"
method: GET
path: "/api/controls/v1/evidence-task-implementations/{evidenceTaskImplementationId}"
tags: ["Evidence Task Implementations"]
---

# Get Evidence Task Implementation

`GET /api/controls/v1/evidence-task-implementations/{evidenceTaskImplementationId}`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/api/controls/v1/evidence-task-implementations/{evidenceTaskImplementationId}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `CONTROL`

Use this API to retrieve a single evidence implementation by its unique identifier.

## Path parameters

- `evidenceTaskImplementationId` string, uuid, required

## Response `200`

OK

- TechRiskComplianceITRiskManagementEvidenceImplementationDto
  - `id` string, uuid: GUID of Evidence Implementation.
  - `number` integer, required: Numeric identifier for Evidence Implementation.
  - `orgGroup` TechRiskComplianceITRiskManagementBasicDetail
    - `id` string, uuid: Identifier (GUID)
    - `name` string: Name
  - `primaryEntity` TechRiskComplianceITRiskManagementEvidenceEntityInformation
    - `id` string, uuid, required: The identifier (GUID) of the related entity.
    - `name` string, required: The name of the entity.
    - `type` 'ControlImplementations' | 'Risks' | 'Assets' | 'ProcessingActivities' | 'Vendors' | 'Entities' | 'Initiatives': The type of the related entity.
    - `evidenceEntityType` TechRiskComplianceITRiskManagementControlEntityTypeInformation, required
      - `id` string, required: ID of the entity type. This can be Assets, Entities, Custom Object GUID in the form of String.
      - `label` string: Name of the EntityType.
      - `translationKey` string: Translation Key of EntityType ID.
      - `moduleName` string: Module Name of EntityType.
      - `seeded` boolean: The parameter is true for Base Entity Type and false for Custom Object/Entity Types by default.
    - `orgGroupId` string, uuid: The identifier (GUID) of the organization which contains the entity.
    - `controlEntityType` TechRiskComplianceITRiskManagementControlEntityTypeInformation
      - `id` string, required: ID of the entity type. This can be Assets, Entities, Custom Object GUID in the form of String.
      - `label` string: Name of the EntityType.
      - `translationKey` string: Translation Key of EntityType ID.
      - `moduleName` string: Module Name of EntityType.
      - `seeded` boolean: The parameter is true for Base Entity Type and false for Custom Object/Entity Types by default.
  - `primaryEntityName` string: Entity Details of the primary implementor.
  - `evidenceTaskId` string, uuid: Master evidence task id.
  - `name` string: Name of the evidence task.
  - `description` string: Description of the evidence task.
  - `guidance` string: Guidance of the evidence task.
  - `collectionInterval` 'ONE_TIME' | 'WEEKLY' | 'BIWEEKLY' | 'MONTHLY' | 'QUARTERLY' | 'BIANNUALY' | 'YEARLY': Entity Details of the primary implementor.
  - `collectionStartDate` string, date: Start of the collection.
  - `lastCollected` string, date: Last evidence collected date.
  - `currentIntervalStatus` 'NotCollected' | 'Collected' | 'OverDue' | 'InProgress': Current interval status.
  - `currentIntervalEndDate` string, date: Current interval end date.
  - `assignee` TechRiskComplianceITRiskManagementBasicEntityReference[]: List of evidence Assignee.
    - `id` string, uuid, required: Identifier of the entity (UUID).
    - `name` string, required: The name of the entity.
    - `nameKey` string: Name of the entity used for translation.
  - `approver` TechRiskComplianceITRiskManagementBasicEntityReference[]: List of evidence approver.
    - `id` string, uuid, required: Identifier of the entity (UUID).
    - `name` string, required: The name of the entity.
    - `nameKey` string: Name of the entity used for translation.
  - `relatedControls` integer: Number of related controls.
  - `related` integer: Number of related entities.
  - `canSplit` boolean: Flag to indicate if evidence can be split.
  - `evidenceTaskType` 'SYSTEM' | 'CUSTOM': Evidence task type.
  - `createdBy` string, uuid: The user or operation the control was created by.
  - `createdDate` string, date-time: The date the control implementation was created.
  - `lastModifiedBy` string, uuid: The user or process the control was last modified by (GUID).
  - `lastModifiedDate` string, date-time: The date the control was last modified.
  - `collectedEvidenceCount` integer: The count for collected evidences.
  - `automaticCollection` 'CONFIGURED' | 'AVAILABLE' | 'NOT_AVAILABLE': Status of the automatic collection configuration.
  - `deleteType` string: Evidence task implementation delete type.
  - `duplicate` boolean: If similar implementation is present from same master evidence for given control implementation.
  - `dueDateOffset` integer: Offset for the due date in days.
  - `collectionStartMonth` string: Start month of the collection.
  - `aiEvidenceAnalysisResult` TechRiskComplianceITRiskManagementAiEvidenceAnalysisResult
    - `overallScore` string
    - `indicator` 'Success' | 'Warning' | 'Error' | 'Empty'
  - `suggestedSystemAvailable` boolean

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500`: Internal Server Error

---

[API](https://skmtc.dev/onetrust/apis/tech-risk-compliance-it-risk-management.md) - [All operations](https://skmtc.dev/onetrust/apis/tech-risk-compliance-it-risk-management/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/tech-risk-compliance-it-risk-management/revisions/d0bfd2a3c53e?raw)