• Platform
    • Overview
      • Risk Cloud Overview
      • Features
      • Services & Support
      • Pricing
    • Capabilities
      • Reporting & Analytics
      • Risk Quantificaton
      • Integrations & API
      • Risk Cloud Exchange
      • Platform Security
    • img
      See why Risk Cloud was rated the #1 GRC platform on the G2 Grid for Winter 2023.
      Learn more
  • Solutions
    • _separator
      • Cyber Risk & Controls Compliance
      • Enterprise Risk Management
      • Third-Party Risk Management
      • Controls Compliance
      • Policy Management
    • _separator
      • Regulatory Compliance
      • Data Privacy
      • Operational Resiliency
      • Environmental, Social & Governance
      • Internal Audit
    • 10 Purpose-Built GRC Solutions. One Connected Platform.
      View All Solutions
  • Industries
    • _separator
      • Industries Overview
      • Software
      • FinTech
      • Telecom
      • Banking
    • _separator
      • Insurance
      • Investment Services
      • Hospitals & Health Systems
      • Pharmaceuticals
      • Medical Devices
    • _separator
      • Oil & Gas
      • Utilities
      • Alternative Energy
  • Company
    • _separator
      • Our Company
      • Careers
      • Executive Team
      • Partners
    • _separator
      • LogicGate News
      • LogicGate Trust Center
      • Contact Us
    • img
      The Root of the Compliance vs Security Paradox
      Upcoming Webinar
      Register Now
  • Resources
    • Risk Cloud Help
      • Help Center
      • Developer Portal
    • Learn + Connect
      • Blog
      • Customer Stories
      • LogicGate Resources
      • LogicGate Events
      • GRC & Me Podcast
    • img
      Five Board Questions That Security and Risk Leaders Must Be Prepared to Answer
      View Report
Request A Demo
img
See why Risk Cloud was rated the #1 GRC platform on the G2 Grid for Winter 2023.
Learn more

Documentation

Menu

  • Quick Start Guides
    • Risk Cloud API: Getting Started
    • Risk Cloud PowerBI Connection
    • Risk Cloud Webhooks
  • API Usage Guides
    • Risk Cloud API: Pagination
    • Risk Cloud API: Record Search
    • Risk Cloud API: Authentication
    • Risk Cloud API: Create Records
    • Risk Cloud API: Export Record Data
    • Risk Cloud API: Update Records
    • Risk Cloud API: Upload Attachments
    • Risk Cloud API: View User Access Audits
    • Risk Cloud API: View Applications, Workflows, and Steps
    • Risk Cloud API: Viewing Fields
    • Risk Cloud API: Viewing Users
    • Risk Cloud API: Create Users
  • Release Notes
    • v2021.4.0 Release Notes
    • v2021.3.0 Release Notes
    • v2021.2.0 Release Notes
    • v2021.1.0 Release Notes
  • Developer Blogs
    • Tidying Up Existing REST APIs
    • Accessibility Improvements at LogicGate
    • What Do We Look for in Developers?
    • 2 Quick Tips I’ve learned for FE Testing as a LogicGate Dev
    • Kotlin at LogicGate
    • Spring Boot with Neo4j & MySQL
  • Case Studies
  • Integrations
    • Vital4 Risk Cloud Connector
    • Ascent Risk Cloud Connector
    • SecurityScorecard Risk Cloud Connector
    • Tenable Risk Cloud Connector
    • Black Kite Risk Cloud Connector
  • Home
  • Developer Resources
  • API Usage Guides

Risk Cloud API: Record Search

Updated on: January 17, 2023

The Risk Cloud API contains the Record Search endpoint GET /api/v1/records/searchto provide a means of searching and filtering Records based on various parameters.

Endpoint

The Record Search endpoint GET /api/v1/records/search is a Paginated endpoint that returns a Page of Records for a given pageand size. Feel free to reference Risk Cloud API: Pagination for more information on how Paginated endpoints function in the Risk Cloud API.

While pageand sizeare optional query parameters for some Paginated endpoints, pageand size are required query parameters for the Record Search endpoint.

The response payload of the Record Search endpoint can be found in our API documentation.

Request

Records by Workflow

To filter the Record Search to only return a Page of Records from a specific Workflow, add the workflowquery parameter to the Record Search request.

  • workflow: the unique ID of a Workflow, filtering the Record Search to only return
    Records from the specified Workflow 

To obtain a Workflow ID, reference Risk Cloud API: View Applications, Workflows, and Steps

Note: page and size query parameters are required for the Record Search endpoint

GET /api/v1/records/search?workflow={workflowId}&page=0&size=20

Linked Child Records

To filter the Record Search to return a Page of Linked Records, add the following query parameters to the Record Search request.

  • parent: the unique ID of the parent Record to seek linked child Records from
  • sourceWorkflow: the unique ID of the Workflow that the parent Record is from
  • workflow: the unique ID of the linked Workflow from which linked child Records are sought
  • mapped: whether the returned Records are linked to the parent Record or not

Note: page and size query parameters are required for the Record Search endpoint

GET /api/v1/records/search?page=0&size=20&parent={recordId}&sourceWorkflow={workflowId}&wo
rkflow={linkedWorkflowId}&mapped=true

Response

The Record Search endpoint returns a Page of Record objects, where the Records are within an array of the content property of the Page. Each Record object of Page’s content array is formatted as shown below.

Property Type Description
properties array A list of Custom Field and System Field properties
properties[].header string The name of the Custom Field or System Field
properties[].fieldType enum The Custom Field type for Custom Fields or null for System Fields
properties[].systemField enum The System Field type for System Fields or null for custom Fields
properties[].recordId string The unique ID of the Record containing this property
properties[].url string The path extension to the Field, only on Record Names
properties[].rawValue object / string / array Either a single Value object, a list of Value objects, or a string  representing, depending on the type of Field
properties[].formattedValue string The string representation of the Value or Values
record object A returned Record
record.id string The unique ID of the Record
record.depth integer The depth of the Record
record.name string The name of the Record
record.dueDate long The Due Date of the Record measured in milliseconds since the Unix epoch
record.user boolean Whether the Record has an assignee
record.canEdit boolean Whether the current User is allowed to edit this Record
record.canRead boolean Whether the current User is allowed to read this Record
record.step Step The current Step of the Record
recird.workflow Workflow The Workflow of the Record
record.application Application The Application of the Record
record.jiraKey string The Jira Key of the Record if
record.stepId string The ID of the current Step of the Record
record.stepEnd boolean Whether the current Step of the Record is an End Step

 

Read Previous API Usage Guides
Read Next API Usage Guides
  • 320 W Ohio St
    Floor 5E
    Chicago, IL 60654
  • 312-279-2775
    • LinkedIn
    • Twitter
    • Youtube
    • Facebook
  • Looking for something specific?
  • Request A Demo
  • Platform
    • Risk Cloud Overview
    • Features
    • Reporting & Analytics
    • Risk Quantification
    • Integrations & API
    • Risk Cloud Exchange
    • Services & Support
    • Pricing
  • Company
    • Careers We're hiring!
    • Executive Team
    • Partners
    • LogicGate News
    • LogicGate Trust Center
    • Contact Us
  • Resources
    • Blog
    • Email Newsletter
    • Resource Center
    • Help Center
    • Developer
  • Solutions
    • Cyber Risk & Controls Compliance
    • Enterprise Risk Management
    • Third-Party Risk Management
    • Controls Compliance
    • Regulatory Compliance
    • Data Privacy Management
    • Operational Resiliency
    • Policy Management
    • Environmental, Social & Governance
    • Internal Audit Management
    • View All Solutions
  • Industries
    • Software
    • FinTech
    • Telecom
    • Banking
    • Insurance
    • Investment Services
    • Healthcare
    • Pharmaceuticals
    • Medical Devices
    • Oil & Gas
    • Utilities
    • Alternative Energy
Also of Interest
  • Connect, Optimize, and Scale Your Cyber Risk...
  • Data Privacy Software Solution
  • Grow Your Relationships Not Your Risks.
  • LinkedIn TwitterYoutubeFacebook

Copyright © 2023. LogicGate, Inc. All rights reserved.

  • Privacy Policy
  • Information Security Overview
  • Site Map

Copyright © 2023. LogicGate, Inc. All rights reserved.