> ## Documentation Index > Fetch the complete documentation index at: https://developers.logicgate.ai/llms.txt > Use this file to discover all available pages before exploring further. # Find scoped assessment by parent record ## OpenAPI ````yaml GET /api/v1/scoped-assessments openapi: 3.1.0 info: title: Risk Cloud API description: >- The Risk Cloud API is a collection of RESTful API endpoints that empower you and your team to directly integrate, automate, and build with the Risk Cloud. Risk Cloud API endpoint payloads are JSON based, with some endpoints supporting exports in CSV and XSLX formats for flexible integration. This API documentation showcases our Risk Cloud API v1, containing a variety of endpoints with continued support for enabling integrations with the Risk Cloud. Visit the [LogicGate Risk Cloud Developer Portal](https://www.logicgate.com/developer/) to get started with building your custom integration with quick start guides, usage guides, release notes, and more. Or download the [v1 OpenAPI specification](/legacy-openapi.json). Explore our [Risk Cloud API v2](https://docs.logicgate.com/v2/index.html) endpoints and documentation as well. [Risk Cloud API v2](https://docs.logicgate.com/v2/index.html) is our collection of API-First endpoints that are tailor made for our developer users, offer concise and highly documented details, are supported by a [Postman collection](https://www.postman.com/logicgate-postman/workspace/logicgate-risk-cloud-api/collection/29257227-de8d264b-6eeb-4177-bea6-2da0a8cabffc) and [v2 OpenAPI specification](https://github.com/LogicGateTech/openapi), and contain our latest API endpoint releases. contact: name: developer-relations@logicgate.com email: developer-relations@logicgate.com version: v2026.11.0 servers: - url: https://{subdomain}.logicgate.com description: Your Risk Cloud environment. variables: subdomain: description: Your Risk Cloud environment's subdomain (e.g. `qa`). default: your-instance security: - ApiToken: [] - basic: [] tags: - name: Authentication description: >- Getting Started: How to create an [API Access Token](https://www.logicgate.com/developer/risk-cloud-api-authentication/) to begin integrating with the Risk Cloud API - name: Attachment description: Endpoints for uploading, downloading, and retrieving record attachments. - name: Field description: Endpoints for creating, updating, and querying fields. - name: Principal description: >- Endpoints for the authenticated principal to view and manage their own details. - name: Record Audit description: Endpoints for retrieving record audit history and productivity data. - name: Step description: Endpoints for retrieving steps and the steps a user can access. - name: Table Report description: Endpoints for retrieving and managing table reports. - name: User Group description: Endpoints for managing user groups and their membership. externalDocs: description: Developer Portal url: https://www.logicgate.com/developer/ paths: /api/v1/scoped-assessments: get: tags: - ScopedAssessment operationId: findScopedAssessmentByParentRecord parameters: - name: parent in: query required: true schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ScopedAssessmentOut' components: schemas: ScopedAssessmentOut: type: object properties: id: type: string created: type: string format: date-time parentRecord: $ref: '#/components/schemas/RecordApiOut' focusRecord: $ref: '#/components/schemas/RecordApiOut' creator: $ref: '#/components/schemas/UserPropertyApiOut' assessmentWorkflow1: $ref: '#/components/schemas/WorkflowSummaryOut' assessmentWorkflow2: $ref: '#/components/schemas/WorkflowSummaryOut' assessmentWf1RecordCount: type: integer format: int32 assessmentWf2RecordCount: type: integer format: int32 required: - assessmentWf1RecordCount - assessmentWf2RecordCount - assessmentWorkflow1 - assessmentWorkflow2 - created - creator - focusRecord - id - parentRecord RecordApiOut: type: object properties: id: type: string description: The unique ID of this Risk Cloud resource example: a1b2c3d4 recordName: type: string description: The workflow prefix and sequence number of the record example: Assessment-7 name: type: string description: >- The text value of the primary field of the record, otherwise the workflow prefix and sequence number of the record example: Medium Risk status: type: string description: The status of the record enum: - INACTIVE - NOT_ASSIGNED - ASSIGNED - IN_PROGRESS - COMPLETE example: IN_PROGRESS sequenceNumber: type: integer format: int64 description: The sequence number of the record example: 7 dates: $ref: '#/components/schemas/RecordDatesApiOut' description: Date information associated with the record assignee: $ref: '#/components/schemas/UserPropertyApiOut' description: The current assignee of the record creator: $ref: '#/components/schemas/UserPropertyApiOut' description: The creator of the record application: $ref: '#/components/schemas/ApplicationPropertyApiOut' description: The parent application of the record workflow: $ref: '#/components/schemas/WorkflowPropertyApiOut' description: The parent workflow of the record currentStep: $ref: '#/components/schemas/StepPropertyApiOut' description: The current step of the record originStep: $ref: '#/components/schemas/StepPropertyApiOut' description: The origin step of the record fields: type: array description: The fields and values of the record items: $ref: '#/components/schemas/FieldRecordApiOut' object: type: string description: Identifies the type of object this data represents example: application required: - application - assignee - creator - currentStep - dates - fields - id - name - object - originStep - recordName - sequenceNumber - status - workflow title: Record (Response) UserPropertyApiOut: type: object properties: id: type: string description: The unique ID of this Risk Cloud resource example: a1b2c3d4 name: type: string description: The name of the user example: Jane Doe email: type: string description: The email of the user example: jane.doe@example.com object: type: string description: Identifies the type of object this data represents example: user required: - email - id - name - object title: User (Property) WorkflowSummaryOut: type: object properties: id: type: string description: ID of the workflow. active: type: boolean description: True if the workflow is active. created: type: string format: date-time description: Created Date of the workflow. updated: type: string format: date-time description: Last Updated Date of the workflow. name: type: string description: Name of the workflow. recordPrefix: type: string description: Prefix to be used for every record created from the workflow. allowGroups: type: boolean description: Nodes created in the workflow are allowed user groups. requireGroups: type: boolean description: Nodes created in the workflow require user groups. xpos: type: integer format: int32 description: X axis position of the workflow on the application screen ypos: type: integer format: int32 description: Y axis position of the workflow on the application screen sla: $ref: '#/components/schemas/ServiceLevelAgreement' description: Object containing all SLA information. allowAec: type: boolean description: Enabled automated evidence collection. applicationId: type: string description: The parent application ID of this workflow. workflowType: type: string description: The type of this workflow (LG or Jira). enum: - WORKFLOW - JIRA_WORKFLOW - CONTROL_WORKFLOW - ANALYSIS_WORKFLOW application: $ref: '#/components/schemas/ApplicationSummaryOut' description: The parent application of this workflow. required: - active - allowAec - allowGroups - application - applicationId - created - id - name - recordPrefix - requireGroups - sla - updated - workflowType - xpos - ypos RecordDatesApiOut: type: object properties: created: type: string format: date-time description: >- The moment this Risk Cloud resource was created measured in milliseconds since the Unix epoch. example: '1672552800000' dueDate: type: string format: date-time description: >- The due date of this record and step SLA measured in milliseconds since the Unix epoch example: '1672552800000' recordDueDate: type: string format: date-time description: >- The due date of this record measured in milliseconds since the Unix epoch example: '1672552800000' daysUntilDue: type: integer format: int64 description: The number of days until this record is due example: 3 updated: type: string format: date-time description: >- The moment this Risk Cloud resource was last updated measured in milliseconds since the Unix epoch. example: '1672552800000' completed: type: string format: date-time description: >- The moment this record was completed if the record is currently in an end step measured in milliseconds since the Unix epoch example: '1672552800000' lastCompleted: type: string format: date-time description: >- The moment this record was last completed regardless of if the record has transitioned from an end step measured in milliseconds since the Unix epoch example: '1672552800000' required: - completed - created - daysUntilDue - dueDate - lastCompleted - recordDueDate - updated title: Record Dates ApplicationPropertyApiOut: type: object properties: id: type: string description: The unique ID of this Risk Cloud resource example: a1b2c3d4 name: type: string description: The name of the application example: Cyber Risk Management Application type: type: string description: The type of Risk Cloud application enum: - ACCESS_MANAGEMENT - AML_KYC - ASSET_MANAGEMENT - AUDIT_MANAGEMENT - BUSINESS_CONTINUITY_PLANNING - CHANGE_MANAGEMENT - COMPLAINT_MANAGEMENT - COMPLIANCE_MANAGEMENT - CONTRACT_MANAGEMENT - CONTROLS_COMPLIANCE - CONTROLS_MANAGEMENT - CRISIS_MANAGEMENT - CUSTOM - CUSTOM_GRC_USE_CASE - CYBER_RISK_MANAGEMENT - DATA_PRIVACY_MANAGEMENT - EMPLOYEE_COMPLIANCE - ENTERPRISE_RISK_MANAGEMENT - ESG - INCIDENT_MANAGEMENT - INTERNAL_AUDIT_MANAGEMENT - IT_RISK_MANAGEMENT - NONE - OPERATIONAL_RESILIENCY - OTHER - POLICY_AND_PROCEDURE_MANAGEMENT - POLICY_MANAGEMENT - PRIVACY_MANAGEMENT - QUANTIFY - REGULATORY_COMPLIANCE - REPOSITORY - RISK_QUANTIFICATION - SOX_TESTING - STANDARDS_REGULATIONS - SURVEY - THIRD_PARTY_RISK_MANAGEMENT example: CONTROLS_COMPLIANCE object: type: string description: Identifies the type of object this data represents example: application required: - id - name - object - type title: Application (Property) WorkflowPropertyApiOut: type: object properties: id: type: string description: The unique ID of this Risk Cloud resource example: a1b2c3d4 name: type: string description: The name of the workflow example: Risk Assessments recordPrefix: type: string description: >- The prefix to be used in the name of every record created from this workflow example: Assessment object: type: string description: Identifies the type of object this data represents example: workflow required: - id - name - object - recordPrefix title: Workflow (Property) StepPropertyApiOut: type: object properties: id: type: string description: The unique ID of this Risk Cloud resource example: a1b2c3d4 name: type: string description: The name of the step example: Identify Risk type: type: string description: The type of the step enum: - ORIGIN - CHAIN - END example: ORIGIN object: type: string description: Identifies the type of object this data represents example: step required: - id - name - object - type title: Step (Property) FieldRecordApiOut: type: object properties: id: type: string description: The unique ID of this Risk Cloud resource example: a1b2c3d4 name: type: string description: The name of the field example: Risk Severity label: type: string description: The label of the field as shown on the record example: Enter the Risk Severity based on your assessment global: type: boolean description: Whether the field is global example: false type: type: string description: The type of the field enum: - DATE - USER - EXTERNAL_USER - TEXT - TEXT_AREA - NUMBER - E_SIGNATURE - CHECKBOX - MULTI_SELECT - RADIO - SELECT - ATTACHMENT - CALCULATION - TEXT_CONCATENATION - LINKED_RECORDS_COUNT - DATE_CALCULATION - OTHER example: SELECT title: Field Type valueType: type: string description: The type of the field value enum: - NUMBER - CALCULATION - ATTACHMENT - DATE - OPTION - USER - TEXT - OTHER example: OPTION required: type: boolean description: Whether the field is required for the current step example: false values: type: array description: The values of the record field items: $ref: '#/components/schemas/ValuePropertyApiOut' object: type: string description: Identifies the type of object this data represents example: field required: - global - id - label - name - object - required - type - valueType - values title: Field (Record) ServiceLevelAgreement: type: object properties: enabled: type: boolean duration: type: integer format: int64 required: - duration - enabled ApplicationSummaryOut: type: object properties: id: type: string active: type: boolean created: type: string format: date-time updated: type: string format: date-time name: type: string type: type: string color: type: string icon: type: string live: type: boolean permissionsEnabled: type: boolean required: - active - color - created - icon - id - live - name - permissionsEnabled - type - updated ValuePropertyApiOut: type: object properties: id: type: string description: The unique ID of this Risk Cloud resource example: a1b2c3d4 type: type: string description: The type of the value enum: - NUMBER - CALCULATION - ATTACHMENT - DATE - OPTION - USER - TEXT - OTHER example: OPTION textValue: type: string description: >- The text representation of the record value, with the format varying by value type: - `NUMBER`: a string representation of the number, with currency if specified on the field (example: `"42"`) - `CALCULATION`: a string representation of the label if specified on the field, otherwise the number (example: `"Highest Risk"`) - `ATTACHMENT`: the name of the attachment file (example: `"my-evidence.pdf"`) - `DATE`: the date formatted according to the requesting user's settings (example: `"1/1/23, 12:00 PM"`) - `OPTION`: the text value of the option (example: `"Medium Risk"`) - `USER`: the full name and email of the user (example: `"First Last (first.last@example.com)"`) - `TEXT`: the text value (example: `"Data Theft"`) example: Medium Risk numericValue: type: number format: double description: >- The numeric representation of the record value, with the format varying by value type: - `NUMBER`: the numeric value of the number (example: `42.0`) - `CALCULATION`: the numeric value of the calculation (example: `42.0`) - `ATTACHMENT`: the version count of the attachment (example: `2.0`) - `DATE`: the date measured in milliseconds since the Unix epoch (example: `1672552800000.0`) - `OPTION`: the numeric value of the option (example: `2.0`) - `USER`: a null value (example: `null`) - `TEXT`: a null value (example: `null`) example: 2 object: type: string description: Identifies the type of object this data represents example: value required: - id - numericValue - object - textValue - type title: Value (Property) securitySchemes: ApiToken: type: http scheme: bearer bearerFormat: API Token basic: type: http scheme: basic ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.