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

# Get risk register by ID

> Get a risk register by ID.

Returns the same fields as each item in `GET /risk-registers`.



## OpenAPI

````yaml /reference/manage-vanta.json get /risk-registers/{riskRegisterId}
openapi: 3.0.0
info:
  title: Manage Vanta
  version: 1.0.0
  description: >-
    The REST API lets customers query and mutate Vanta's data. Use this API to
    automate bulk actions, query data for custom workflows and dashboards, and
    bolster your security operations


    **Note for Vanta Gov (FedRAMP) customers:** Select `Vanta Gov (FedRAMP)`
    from the server dropdown to issue requests against
    `https://api.vanta-gov.com`. The OAuth token URL shown below defaults to the
    commercial host — replace it with `https://api.vanta-gov.com/oauth/token`.
  termsOfService: https://www.vanta.com/terms
  license:
    name: UNLICENSED
  contact:
    name: API Support
    url: https://help.vanta.com/
    email: support@vanta.com
servers:
  - url: https://api.vanta.com/v1
    description: Vanta (Commercial)
  - url: https://api.vanta-gov.com/v1
    description: Vanta Gov (FedRAMP)
security: []
paths:
  /risk-registers/{riskRegisterId}:
    get:
      tags:
        - Risk Registers
      summary: Get risk register by ID
      description: |-
        Get a risk register by ID.

        Returns the same fields as each item in `GET /risk-registers`.
      operationId: GetRiskRegister
      parameters:
        - in: path
          name: riskRegisterId
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RiskRegister'
              examples:
                Example 1:
                  value:
                    id: 5f2c939a52855e725c8d5824
                    name: Default
                    description: null
                    registerType: SCOPED
                    creationDate: '2024-03-07T18:46:05.944Z'
                    settings:
                      applicableCustomFields:
                        - Business unit
      security:
        - bearerAuth: []
components:
  schemas:
    RiskRegister:
      description: |-
        A risk register — a grouping of risk scenarios.

        Risk scenarios reference their register by **name** (the `riskRegister`
        field on `CreateRiskScenarioInput` and `RiskScenario`). Domains with
        multiple registers must specify a register name on create.
      properties:
        id:
          type: string
          description: The unique ID of the risk register.
        name:
          type: string
          description: |-
            The name of the risk register. This is the value used in the
            `riskRegister` field on risk-scenario create and update requests.
        description:
          type: string
          nullable: true
          description: Optional description of this register.
        registerType:
          $ref: '#/components/schemas/RestRiskRegisterType'
          description: |-
            Whether this is a scoped user-managed register or the system-managed
            enterprise register.
        creationDate:
          type: string
          format: date-time
          description: When this risk register was created.
        settings:
          $ref: '#/components/schemas/RiskRegisterSettings'
          description: Configuration that applies to the risk scenarios in this register.
      required:
        - id
        - name
        - description
        - registerType
        - creationDate
        - settings
      type: object
      additionalProperties: false
    RestRiskRegisterType:
      type: string
      enum:
        - SCOPED
        - ENTERPRISE
    RiskRegisterSettings:
      properties:
        applicableCustomFields:
          items:
            type: string
          type: array
          description: >-
            Labels of the custom fields that apply to risk scenarios in this
            register.

            These are the labels accepted in the `customFields` field on
            risk-scenario

            create and update requests for this register. The enterprise
            register

            lists every custom field, since enterprise risks accept all of them.

            Empty if the organization doesn't have custom fields.
      required:
        - applicableCustomFields
      type: object
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

## Related topics

- [Get risk scenario by ID](https://developer.vanta.com/api-reference/risk-scenarios/get-risk-scenario-by-id.md)
- [List risk registers](https://developer.vanta.com/api-reference/risk-registers/list-risk-registers.md)
- [Create and update risk scenarios](https://developer.vanta.com/docs/guides/create-risk-scenarios.md)
- [Get vendor by ID](https://developer.vanta.com/api-reference/vendors/get-vendor-by-id.md)
- [Get issue by ID](https://developer.vanta.com/api-reference/issues/get-issue-by-id.md)