Skip to Content

Documentation

Risk Cloud API: Linked Record Search

Whether it’s for parent records or a child records, the Risk Cloud’s Record API empowers integration use cases to automate and process linked records.

Obtain your API Access Token to get started.

Retrieve Linked Records Endpoints

The Record API offers the following Retrieve All Linked Records endpoint which return lists of all records that are either the parent or child records of a given source record.

Retrieve All Linked Records

Retrieve a page of all records that are linked to the record of the given record ID that the current user has Read or Write access to. The maximum depth of linked records to return with regards to the relationship between the records can be specified by the depth property, which defaults to 10.

This endpoint reflects the functionality of Relationship Reports in the Risk Cloud.

This endpoint has the following additional query parameters for filtering:

Query ParameterRequiredDescription
workflow-idYesThe unique ID of a workflow where, if provided, the response will only contain linked records from the identified workflow
depthNoSpecifies the maximum depth of linked records to return with regards to the relationship between the given record’s workflow and the workflow specified by workflow-id (must not be less than 0, defaults to 10)
updated-minNoA timestamp measured in milliseconds since the Unix epoch where, if provided, the response will only contain records that have been modified since the given timestamp
pageNoThe zero-indexed page number (must not be less than 0, defaults to 0)
sizeNoThe size of the page and maximum number of items to be returned (must not be less than 1, defaults to 20)

Use Cases

Obtain Value ID

To obtain the value id of a particular record, use the Risk Cloud API: Record Search endpoint to search and filter records by application and workflow.

The value id of a record can be located in the response of the Record Search endpoint in the property content[].id. In the below sample the value ID would be abcd1234 (ellipses are used to omit information for clarity).

Response

{
  "content": [
    {
      "id": "abcd1234",
      ...
    }
  ],
  ...
}