---
agentTools:
  projectIndex: https://riskledger.readme.io/llms.txt
---

# get risk by ID

get risks related to your org by UUID

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "description": "Risk Ledger API",
    "title": "Risk Ledger API",
    "version": "alpha"
  },
  "paths": {
    "/risks/{riskID}": {
      "get": {
        "security": [
          {
            "api_key": []
          }
        ],
        "description": "get risks related to your org by UUID",
        "tags": [
          "Risks"
        ],
        "summary": "get risk by ID",
        "operationId": "GetRiskRequest",
        "parameters": [
          {
            "x-go-name": "RiskID",
            "name": "riskID",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/GetRiskResponse"
          }
        }
      }
    }
  },
  "security": [
    {
      "api_key": []
    }
  ],
  "servers": [
    {
      "url": "https://api.riskledger.com/alpha"
    }
  ],
  "components": {
    "responses": {
      "GetRiskResponse": {
        "description": "GetRiskResponse is the response for getting information about a specific risk that is related to your organisation.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Risk"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      }
    },
    "schemas": {
      "AssignedUser": {
        "type": "object",
        "properties": {
          "firstName": {
            "description": "First name of the user.",
            "type": "string",
            "x-go-name": "FirstName",
            "example": "Joe"
          },
          "id": {
            "description": "User's UUID.",
            "type": "string",
            "x-go-name": "ID",
            "example": "7a0d34a6-ae8c-4ced-9b4a-3de0dbd86df2"
          },
          "lastName": {
            "description": "Last name of the user.",
            "type": "string",
            "x-go-name": "LastName",
            "example": "Bloggs"
          },
          "team": {
            "description": "A string indicating the team of the user. Possible values include: \"sales\", \"security\", \"compliance\", \"procurement\", \"legal\", \"esg\", \"it\" or \"other\"",
            "type": "string",
            "x-go-name": "Team",
            "example": "\"security\""
          }
        },
        "x-go-package": "riskledger.com/rl/services/api_public/pkg/models"
      },
      "Risk": {
        "type": "object",
        "properties": {
          "assignedUsers": {
            "description": "A list of users assigned to the risk.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AssignedUser"
            },
            "x-go-name": "AssignedUsers"
          },
          "associatedID": {
            "description": "UUID of associated item.",
            "type": "string",
            "x-go-name": "AssociatedID",
            "example": "3c17fb1e-567d-4689-be9d-37148c1efd78"
          },
          "associatedType": {
            "description": "Type of item associated with the risk.",
            "type": "string",
            "x-go-name": "AssociatedType",
            "example": "control"
          },
          "closedAt": {
            "description": "Timestamp of when risk is closed. Will be null\nunless the risk is closed.",
            "type": "string",
            "format": "date-time",
            "x-go-name": "ClosedAt",
            "example": "2022-10-20T09:55:36.083395Z"
          },
          "closedBy": {
            "description": "UUID of user that closed the risk. Will be null\nunless the risk is closed.",
            "type": "string",
            "x-go-name": "ClosedBy",
            "example": "9b407587-365a-4ad0-9851-42d2ee590711"
          },
          "createdAt": {
            "description": "Timestamp of when risk is created.",
            "type": "string",
            "format": "date-time",
            "x-go-name": "CreatedAt",
            "example": "2022-10-11T15:12:02.068989Z"
          },
          "createdBy": {
            "description": "UUID of user that created the risk",
            "type": "string",
            "x-go-name": "CreatedBy",
            "example": "950e60c7-aa3e-4bdb-8a19-d62a614d2c75"
          },
          "description": {
            "description": "Description of the risk.",
            "type": "string",
            "x-go-name": "Description",
            "example": "This is a test risk for the public API"
          },
          "id": {
            "description": "Risk UUID.",
            "type": "string",
            "x-go-name": "ID",
            "example": "7a0d34a6-ae8c-4ced-9b4a-3de0dbd86df2"
          },
          "impact": {
            "description": "Impact of the risk.",
            "type": "string",
            "x-go-name": "Impact",
            "example": "high"
          },
          "likelihood": {
            "description": "Likelihood of the risk.",
            "type": "string",
            "x-go-name": "Likelihood",
            "example": "low"
          },
          "modifiedAt": {
            "description": "Timestamp of when the risk is modified.",
            "type": "string",
            "format": "date-time",
            "x-go-name": "ModifiedAt",
            "example": "2022-10-21T11:24:33.801403Z"
          },
          "modifiedBy": {
            "description": "UUID of user that has modified the risk last.",
            "type": "string",
            "x-go-name": "ModifiedBy",
            "example": "99871aee-5e9c-40f5-8281-e5e60026cf28"
          },
          "name": {
            "description": "Name of the risk.",
            "type": "string",
            "x-go-name": "Name",
            "example": "Risky business"
          },
          "number": {
            "description": "Risk number, used as human readable identifiers.",
            "type": "integer",
            "format": "int64",
            "x-go-name": "Number",
            "example": 36
          },
          "openedAt": {
            "description": "Timestamp of when risk is opened. This will be\ndifferent than createdAt if a risk is opened after\nbeing closed.",
            "type": "string",
            "format": "date-time",
            "x-go-name": "OpenedAt",
            "example": "2022-10-11T15:12:02.068989Z"
          },
          "openedBy": {
            "description": "UUID of user that opened the risk.",
            "type": "string",
            "x-go-name": "OpenedBy",
            "example": "950e60c7-aa3e-4bdb-8a19-d62a614d2c75"
          },
          "riskOwner": {
            "description": "Name of the risk owner.",
            "type": "string",
            "x-go-name": "RiskOwner",
            "example": "Risk Ledger"
          },
          "riskScore": {
            "description": "Risk score",
            "type": "integer",
            "format": "int32",
            "x-go-name": "RiskScore",
            "example": 2
          },
          "riskType": {
            "description": "Risk Type",
            "type": "string",
            "x-go-name": "RiskType",
            "example": "concentration"
          },
          "status": {
            "$ref": "#/components/schemas/Status"
          },
          "supplierID": {
            "description": "UUID of supplier risk is opened against.",
            "type": "string",
            "x-go-name": "SupplierID",
            "example": "0e5dd51b-644c-4488-af96-2bec5a7dbb3b"
          }
        },
        "x-go-package": "riskledger.com/rl/services/api_public/pkg/models"
      },
      "Status": {
        "type": "integer",
        "format": "int32",
        "x-go-package": "riskledger.com/rl/proto/risk/v2"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "_id": {
    "buffer": {
      "0": 106,
      "1": 96,
      "2": 185,
      "3": 195,
      "4": 110,
      "5": 178,
      "6": 6,
      "7": 165,
      "8": 201,
      "9": 58,
      "10": 139,
      "11": 181
    }
  }
}
```