Sign in

v1

latestOpenAPI 3.1.0Apache 2.02026-07-245981,1853.0 MB
Control Implementations

Get Control Implementation

Use this API to retrieve a single control implementation by its unique identifier along with the associated attributes, category, and framework details.

get/api/controls/v1/control-implementations/{guid}

Path parameters

guidstring uuid required

ID of the control entity implementation.

Response

OK

idstring uuid required

GUID of Control Implementation.

numberinteger required

Numeric identifier for Control Implementation.

organizationIdstring uuid required

The identifier (GUID) of the organization implementation.

orgGroupNamestring required

Organization name with which control implementation is created.

status'Pending' | 'Implemented' | 'NotDoing' | 'Suggested' required

The status of the control.

suggestion'Suggested' | 'Accepted' | 'Rejected'

The suggestion status of the control. Used by Athena.

effectiveness'Effective' | 'Ineffective' | 'Planned'

The effectiveness of the control.

notestring

Notes used for the control. This is free text to contain any additional details which may be needed.

deadlinestring date

The deadline for the control.

createdBystring uuid

The user or operation the control was created by.

createDtstring date-time

The date on which the control implementation was created.

lastModifiedBystring uuid

The user or process the control was last modified by (GUID).

lastModifiedDatestring date-time

The date the control was last modified.

controlObjectivesCountinteger

count of total control objectives linked.

attributesobject

Implemented Custom Attributes.

deleteType'SOFT'

Control implementation delete type.

controlImplementationNamestring

Control Implementation Name of the implemented control.

controlImplementationDescriptionstring

Control Implementation Description of the implemented control.

controlImplementationGuidancestring

Control Implementation Guidance of the implemented control.

controlImplementationCategoryIdstring uuid

Control Implementation Category of the implemented control.

controlImplementationCategoryNamestring

Control Implementation Category Name of the implemented control.

controlImplementationCategoryNameKeystring

Control Implementation Name of the implemented control.

controlImplementationOriginstring

Control Implementation Origin of the implemented control.

externalImplementationURLstring

External ImplementationURL of the implemented control.

externalControlImplementationboolean

is this an external control implementation.

duplicateEvidenceTaskImplPresentboolean

Duplicate evidence task implementation present.

hasMoreThanOneInvLinksboolean

Implementation has more than one inventory links.

inventoriesCountinteger

Related inventories count.

risksCountinteger

Related risks count.

Example response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "number": 123,
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "orgGroupName": "Organization1",
  "primaryEntity": {
    "id": "1ab2fff0-cb80-b560-99a1-4a3b527f61f5",
    "name": "Asset 305",
    "type": "Risks",
    "controlEntityType": {
      "id": "1a2b3c4e-5f6g-7h8i-9j0k-1l2m3n4o5p6q",
      "label": "Assets",
      "translationKey": "Assets",
      "moduleName": "DataMapping",
      "seeded": true
    },
    "organizationId": "1ab2fff0-cb80-b560-99a1-4a3b527f61f5",
    "relationshipLabel": "IMPLEMENTED_ON",
    "isPrimary": true
  },
  "control": {
    "id": "1a2b3c4e-5f6g-7h8i-9j0k-1l2m3n4o5p6q",
    "identifier": "A.5.1.1",
    "name": "Control Name",
    "description": "Test Controls for Privacy",
    "orgGroupId": "1a2b3c4e-5f6g-7h8i-9j0k-1l2m3n4o5p6q",
    "orgGroupName": "ABC Corp",
    "frameworkId": "1a2b3c4e-5f6g-7h8i-9j0k-1l2m3n4o5p6q",
    "categoryId": "1a2b3c4e-5f6g-7h8i-9j0k-1l2m3n4o5p6q",
    "categoryName": "Privacy",
    "categoryNameKey": "ControlName",
    "frameworkName": "Framework 123",
    "implementationGuidance": "Implementation guidance of the control requirement."
  },
  "status": "Implemented",
  "suggestion": "Suggested",
  "effectiveness": "Effective",
  "effectivenessInfo": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Entity Name",
    "nameKey": "EntityName"
  },
  "note": "Testing control value",
  "deadline": "2020-11-05",
  "maturity": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Entity Name",
    "nameKey": "EntityName"
  },
  "statusInfo": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Entity Name",
    "nameKey": "EntityName"
  },
  "owner": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Entity Name",
    "nameKey": "EntityName"
  },
  "owners": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Entity Name",
      "nameKey": "EntityName"
    }
  ],
  "approvers": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Entity Name",
      "nameKey": "EntityName"
    }
  ],
  "createdBy": "1a2b3c4e-5f6g-7h8i-9j0k-1l2m3n4o5p6q",
  "createDt": "2020-11-05T22:01:21.200+00:00",
  "lastModifiedBy": "123e4567-e89b-12d3-a456-426614174001",
  "lastModifiedDate": "2020-11-05T22:01:21.200+00:0",
  "controlObjectivesCount": 4,
  "entityLinks": [
    {
      "id": "1ab2fff0-cb80-b560-99a1-4a3b527f61f5",
      "name": "Asset 305",
      "type": "Risks",
      "controlEntityType": {
        "id": "1a2b3c4e-5f6g-7h8i-9j0k-1l2m3n4o5p6q",
        "label": "Assets",
        "translationKey": "Assets",
        "moduleName": "DataMapping",
        "seeded": true
      },
      "organizationId": "1ab2fff0-cb80-b560-99a1-4a3b527f61f5",
      "relationshipLabel": "IMPLEMENTED_ON",
      "isPrimary": true
    }
  ],
  "workflow": {
    "id": "1a2b3c4e-5f6g-7h8i-9j0k-1l2m3n4o5p6q",
    "name": "Entity Name",
    "nameKey": "EntityNameKey"
  },
  "workflowStage": {
    "id": "1a2b3c4e-5f6g-7h8i-9j0k-1l2m3n4o5p6q",
    "name": "Entity Name",
    "nameKey": "EntityNameKey",
    "currentStageApprovers": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174003",
        "firstName": "John",
        "lastName": "Doe",
        "approvedTimeStamp": "2020-11-05T22:01:21.200+00:00",
        "status": "approved"
      }
    ]
  },
  "deleteType": "SOFT",
  "controlImplementationName": "Control Implementation name",
  "controlImplementationDescription": "Control Implementation Description",
  "controlImplementationGuidance": "Control Implementation Guidance",
  "controlImplementationCategoryId": "Control Implementation Category Id",
  "controlImplementationCategoryName": "Control Category Name",
  "controlImplementationCategoryNameKey": "Control Category Name Key",
  "controlImplementationOrigin": "Control Implementation Origin",
  "externalImplementationURL": "Control Implementation Link",
  "externalControlImplementation": true,
  "duplicateEvidenceTaskImplPresent": true,
  "hasMoreThanOneInvLinks": true,
  "inventoriesCount": 3,
  "risksCount": 1
}