---
title: "Get control by an ID"
method: GET
path: "/controls/{controlId}"
tags: ["Controls"]
---

# Get control by an ID

`GET /controls/{controlId}`

Get a control by an ID.

## Path parameters

- `controlId` string, required

## Response `200`

Ok

- ControlDetail
  - `id` string, required — The control's unique ID.
  - `externalId` string, nullable, required — The control's external ID.
  - `name` string, required — The control's name.
  - `description` string, required — The control's description.
  - `source` 'Vanta' | 'Custom', required
  - `domains` string[], required — The security domains that the control belongs to.
  - `owner` Owner, required
    - `id` string, required — Unique identifier for the person.
    - `displayName` string, required — Name of the person that is shown in product.
    - `emailAddress` string, required — Email address of the person.
  - `role` string, nullable — The control's GDPR role, if the control is a GDPR control.
  - `customFields` CustomField[], required — The control's custom field values, if control custom fields is included in your Vanta instance.
    - `label` string, required
    - `value` union, required
      - string
      - string[]
  - `creationDate` string, date-time, nullable, required — When the control was created. Returns null for Vanta library controls.
  - `modificationDate` string, date-time, nullable, required — When the control was last modified. Returns null for Vanta library controls.
  - `numDocumentsPassing` number, double, required — The number of passing documents that are linked to the control.
  - `numDocumentsTotal` number, double, required — The total number of documents that are linked to the control.
  - `numTestsPassing` number, double, required — The number of passing tests that are linked to the control.
  - `numTestsTotal` number, double, required — The total number of tests that are linked to the control.
  - `status` 'NO_EVIDENCE_MAPPED' | 'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED', required
  - `note` string, nullable, required — A user created note for the control.

---

[API](https://skmtc.net/vanta/apis/build-integrations.md) · [All operations](https://skmtc.net/vanta/apis/build-integrations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vanta/build-integrations/revisions/6c1f7590538b/schema)