API

Quality management APIs

GET quality/risk-assessments/{riskAssessmentId}

Shows risk assessment

HTTP method GET
URI https://api.rambase.net/quality/risk-assessments/{riskAssessmentId}
Supported formats Xml, Html, Json (ex. $format=json)
- URI parameter {riskAssessmentId} Risk assessment identifier
Integer, minimum 100000
Custom fields Custom fields supported
Successful HTTP status code 200
API resource identifier 5110, version 28

The following body must be added to the request. Mouse over fieldnames for description and other useful information about the fields. Note that fields in bold are required/mandatory.

Format:
1
1

The query string is placed after the resource URL, seperated with a questionmark (?). The query string is composed of a series of query parameters with values. See the page about query parameters on how to use these parameters.

$showDomainDescriptions Boolean, optional Set to "true" to include domain descriptions for fields using domain values. See the Domain values page for more information. Default value is false.
$lang String, optional Specifies the language used in the response, following the 3-letter ISO-639-1 [lll]
$access_token String, optional After successful login you get an access token which needs to be provided in all API requests. Even though it is possible to pass this token as query parameter, we recommended passing it using the HTTP request header as described in Authorization. Note that all access tokens have an expiration time.
$db String, optional Set the database/company for the request
$format String, optional Set the format of the response to use for the request. Accepted values are "xml", "html", "jsonstream", "json"
$useMinimumVersion Integer, optional Used to run a new version of an API resource when your API client is running a deprecated API resource. See the Breaking changes page for more information.
$select String, optional Use to define the fields to return in the response. Accepts a comma-separated list of field names. See the Expand and select page for more information.
$expand String, optional Use to include output fields that are not returned by default in the response. Accepts a comma-separated list of expandable field names. See the Expand and Select page for more information.
$showCustomFields Boolean, optional Set to "true" to include custom fields. Default value is false.

Read more about filters and sorting on how to use filter parameters and named filters.

Read more about filters and sorting on how to use sortable parameters

Requesting this resource will yield the following response. Mouse over fieldnames (or fieldgroups) for descriptions and other useful information about the fields. Fields colored in grey is expandable fields.

Please note that some fields may be removed from the response, based on user roles/duties/permissions.

Format:
1
<RiskAssessment>
2
     <RiskAssessmentId
RiskAssessmentId

Risk assessment identifier

>{Integer}</RiskAssessmentId>
3
     <Status
Status

Status of risk assessment

Possible domain values can be found here

>{Integer}</Status>
4
     <Name
Name

Name of the risk assessment

>{String}</Name>
5
     <CreatedAt
CreatedAt

Date and time when risk assessment was created

>{Datetime}</CreatedAt>
6
     <Scope
Scope

Scope of the risk assessment

>{String}</Scope>
7
     <Limitations
Limitations

Limitations of the risk assessment

>{String}</Limitations>
8
     <AssessmentDate
AssessmentDate

When current assessment was prepared

>{Date}</AssessmentDate>
9
     <NextAssessmentDate
NextAssessmentDate

Date when update of the current risk assessment is planned

>{Date}</NextAssessmentDate>
10
     <ReAssessmentInterval
ReAssessmentInterval

Re-assessment interval

Possible domain values can be found here

>{Integer}</ReAssessmentInterval>
11
     <IsTemplate
IsTemplate

This field indicates if risk assessment is marked as a template assessment

>{Boolean}</IsTemplate>
12
     <Folder>
13
          <FolderId
FolderId

File folder id for a spesific file container or forlder.

>{Integer}</FolderId>
14
          <Name
Name

Verbose folder text in english.

>{String}</Name>
15
          <FolderLink
FolderLink

Company folder id

>{String}</FolderLink>
16
     </Folder>
17
     <InitialRiskAssessment>
18
          <RiskAssessmentId
RiskAssessmentId

Identifier of the first assessment in this line of reassessments

>{Integer}</RiskAssessmentId>
19
          <RiskAssessmentLink
RiskAssessmentLink

API reference to the object

>{String}</RiskAssessmentLink>
20
     </InitialRiskAssessment>
21
     <PositiveScore
PositiveScore

This field is greyed out because it is an expandable field. You have to add $expand=PositiveScore in your request URI to get this field

>
22
          <Score
Score

Score of the potential consequence. Calculated from severity rating multiplied with likelihood level

This field is greyed out because it is an expandable field. You have to add $expand=PositiveScore in your request URI to get this field

>{Integer}</Score>
23
          <QualityConsequenceArea
QualityConsequenceArea

This field is greyed out because it is an expandable field. You have to add $expand=PositiveScore in your request URI to get this field

>
24
               <LowerThreshold
LowerThreshold

Threshold for risk scores. Values less than or equal to this threshold will have a low risk. Medium or higher risks have risk scores greater than this threshold value

This field is greyed out because it is an expandable field. You have to add $expand=PositiveScore in your request URI to get this field

>{Integer}</LowerThreshold>
25
               <UpperThreshold
UpperThreshold

Threshold for risk scores. Values less than this threshold will have a low or medium risk. High risks will have risk scores greater than or equal to this threshold value

This field is greyed out because it is an expandable field. You have to add $expand=PositiveScore in your request URI to get this field

>{Integer}</UpperThreshold>
26
          </QualityConsequenceArea>
27
     </PositiveScore>
28
     <NegativeScore
NegativeScore

This field is greyed out because it is an expandable field. You have to add $expand=NegativeScore in your request URI to get this field

>
29
          <Score
Score

Score of the potential consequence. Calculated from severity rating multiplied with likelihood level

This field is greyed out because it is an expandable field. You have to add $expand=NegativeScore in your request URI to get this field

>{Integer}</Score>
30
          <QualityConsequenceArea
QualityConsequenceArea

This field is greyed out because it is an expandable field. You have to add $expand=NegativeScore in your request URI to get this field

>
31
               <LowerThreshold
LowerThreshold

Threshold for risk scores. Values less than or equal to this threshold will have a low risk. Medium or higher risks have risk scores greater than this threshold value

This field is greyed out because it is an expandable field. You have to add $expand=NegativeScore in your request URI to get this field

>{Integer}</LowerThreshold>
32
               <UpperThreshold
UpperThreshold

Threshold for risk scores. Values less than this threshold will have a low or medium risk. High risks will have risk scores greater than or equal to this threshold value

This field is greyed out because it is an expandable field. You have to add $expand=NegativeScore in your request URI to get this field

>{Integer}</UpperThreshold>
33
          </QualityConsequenceArea>
34
     </NegativeScore>
35
     <Responsible
Responsible

This field is greyed out because it is an expandable field. You have to add $expand=Responsible in your request URI to get this field

>
36
          <EmployeeId
EmployeeId

Employee identifier

This field is greyed out because it is an expandable field. You have to add $expand=Responsible in your request URI to get this field

>{Integer}</EmployeeId>
37
          <LastName
LastName

Last name of employee

This field is greyed out because it is an expandable field. You have to add $expand=Responsible in your request URI to get this field

>{String}</LastName>
38
          <FirstName
FirstName

First name of employee

This field is greyed out because it is an expandable field. You have to add $expand=Responsible in your request URI to get this field

>{String}</FirstName>
39
          <EmployeeLink
EmployeeLink

Employee reference

This field is greyed out because it is an expandable field. You have to add $expand=Responsible in your request URI to get this field

>{String}</EmployeeLink>
40
     </Responsible>
41
     <Location
Location

This field is greyed out because it is an expandable field. You have to add $expand=Location in your request URI to get this field

>
42
          <LocationId
LocationId

Location identifier

This field is greyed out because it is an expandable field. You have to add $expand=Location in your request URI to get this field

>{Integer}</LocationId>
43
          <ShortName
ShortName

Unique abbreviation/short name of the location

This field is greyed out because it is an expandable field. You have to add $expand=Location in your request URI to get this field

>{String}</ShortName>
44
          <LocationLink
LocationLink

Location reference

This field is greyed out because it is an expandable field. You have to add $expand=Location in your request URI to get this field

>{String}</LocationLink>
45
     </Location>
46
     <Totals
Totals

This field is greyed out because it is an expandable field. You have to add $expand=Totals in your request URI to get this field

>
47
          <AcceptedRisksCount
AcceptedRisksCount

Count of accepted risks that belong to this risk assessment

This field is greyed out because it is an expandable field. You have to add $expand=Totals in your request URI to get this field

>{Integer}</AcceptedRisksCount>
48
          <RisksCount
RisksCount

Count of all risks that belong to this risk assessment

This field is greyed out because it is an expandable field. You have to add $expand=Totals in your request URI to get this field

>{Integer}</RisksCount>
49
          <ParticipantsCount
ParticipantsCount

Count of participants

This field is greyed out because it is an expandable field. You have to add $expand=Totals in your request URI to get this field

>{Integer}</ParticipantsCount>
50
          <ActionsCount
ActionsCount

Number of actions related to this risk assessment

This field is greyed out because it is an expandable field. You have to add $expand=Totals in your request URI to get this field

>{Integer}</ActionsCount>
51
          <ControlsCount
ControlsCount

Number of controls related to this risk assessment

This field is greyed out because it is an expandable field. You have to add $expand=Totals in your request URI to get this field

>{Integer}</ControlsCount>
52
     </Totals>
53
     <Context
Context

This field is greyed out because it is an expandable field. You have to add $expand=Context in your request URI to get this field

>
54
          <Source
Source

This field is greyed out because it is an expandable field. You have to add $expand=Context in your request URI to get this field

>
55
               <ObjectId
ObjectId

Identifier of the object

This field is greyed out because it is an expandable field. You have to add $expand=Context in your request URI to get this field

>{Integer}</ObjectId>
56
               <ObjectType
ObjectType

Type of object

This field is greyed out because it is an expandable field. You have to add $expand=Context in your request URI to get this field

>{String}</ObjectType>
57
               <ObjectLink
ObjectLink

API reference to the object

This field is greyed out because it is an expandable field. You have to add $expand=Context in your request URI to get this field

>{String}</ObjectLink>
58
          </Source>
59
     </Context>
60
</RiskAssessment>
1
{
2
     "riskAssessment": {
3
          "riskAssessmentId
RiskAssessmentId

Risk assessment identifier

": "{Integer}",
4
          "status
Status

Status of risk assessment

Possible domain values can be found here

": "{Integer}",
5
          "name
Name

Name of the risk assessment

": "{String}",
6
          "createdAt
CreatedAt

Date and time when risk assessment was created

": "{Datetime}",
7
          "scope
Scope

Scope of the risk assessment

": "{String}",
8
          "limitations
Limitations

Limitations of the risk assessment

": "{String}",
9
          "assessmentDate
AssessmentDate

When current assessment was prepared

": "{Date}",
10
          "nextAssessmentDate
NextAssessmentDate

Date when update of the current risk assessment is planned

": "{Date}",
11
          "reAssessmentInterval
ReAssessmentInterval

Re-assessment interval

Possible domain values can be found here

": "{Integer}",
12
          "isTemplate
IsTemplate

This field indicates if risk assessment is marked as a template assessment

": "{Boolean}",
13
          "folder": {
14
               "folderId
FolderId

File folder id for a spesific file container or forlder.

": "{Integer}",
15
               "name
Name

Verbose folder text in english.

": "{String}",
16
               "folderLink
FolderLink

Company folder id

": "{String}"
17
          },
18
          "initialRiskAssessment": {
19
               "riskAssessmentId
RiskAssessmentId

Identifier of the first assessment in this line of reassessments

": "{Integer}",
20
               "riskAssessmentLink
RiskAssessmentLink

API reference to the object

": "{String}"
21
          },
22
          "positiveScore
PositiveScore

This field is greyed out because it is an expandable field. You have to add $expand=PositiveScore in your request URI to get this field

": {
23
               "score
Score

Score of the potential consequence. Calculated from severity rating multiplied with likelihood level

This field is greyed out because it is an expandable field. You have to add $expand=PositiveScore in your request URI to get this field

": "{Integer}",
24
               "qualityConsequenceArea
QualityConsequenceArea

This field is greyed out because it is an expandable field. You have to add $expand=PositiveScore in your request URI to get this field

": {
25
                    "lowerThreshold
LowerThreshold

Threshold for risk scores. Values less than or equal to this threshold will have a low risk. Medium or higher risks have risk scores greater than this threshold value

This field is greyed out because it is an expandable field. You have to add $expand=PositiveScore in your request URI to get this field

": "{Integer}",
26
                    "upperThreshold
UpperThreshold

Threshold for risk scores. Values less than this threshold will have a low or medium risk. High risks will have risk scores greater than or equal to this threshold value

This field is greyed out because it is an expandable field. You have to add $expand=PositiveScore in your request URI to get this field

": "{Integer}"
27
               }
28
          },
29
          "negativeScore
NegativeScore

This field is greyed out because it is an expandable field. You have to add $expand=NegativeScore in your request URI to get this field

": {
30
               "score
Score

Score of the potential consequence. Calculated from severity rating multiplied with likelihood level

This field is greyed out because it is an expandable field. You have to add $expand=NegativeScore in your request URI to get this field

": "{Integer}",
31
               "qualityConsequenceArea
QualityConsequenceArea

This field is greyed out because it is an expandable field. You have to add $expand=NegativeScore in your request URI to get this field

": {
32
                    "lowerThreshold
LowerThreshold

Threshold for risk scores. Values less than or equal to this threshold will have a low risk. Medium or higher risks have risk scores greater than this threshold value

This field is greyed out because it is an expandable field. You have to add $expand=NegativeScore in your request URI to get this field

": "{Integer}",
33
                    "upperThreshold
UpperThreshold

Threshold for risk scores. Values less than this threshold will have a low or medium risk. High risks will have risk scores greater than or equal to this threshold value

This field is greyed out because it is an expandable field. You have to add $expand=NegativeScore in your request URI to get this field

": "{Integer}"
34
               }
35
          },
36
          "responsible
Responsible

This field is greyed out because it is an expandable field. You have to add $expand=Responsible in your request URI to get this field

": {
37
               "employeeId
EmployeeId

Employee identifier

This field is greyed out because it is an expandable field. You have to add $expand=Responsible in your request URI to get this field

": "{Integer}",
38
               "lastName
LastName

Last name of employee

This field is greyed out because it is an expandable field. You have to add $expand=Responsible in your request URI to get this field

": "{String}",
39
               "firstName
FirstName

First name of employee

This field is greyed out because it is an expandable field. You have to add $expand=Responsible in your request URI to get this field

": "{String}",
40
               "employeeLink
EmployeeLink

Employee reference

This field is greyed out because it is an expandable field. You have to add $expand=Responsible in your request URI to get this field

": "{String}"
41
          },
42
          "location
Location

This field is greyed out because it is an expandable field. You have to add $expand=Location in your request URI to get this field

": {
43
               "locationId
LocationId

Location identifier

This field is greyed out because it is an expandable field. You have to add $expand=Location in your request URI to get this field

": "{Integer}",
44
               "shortName
ShortName

Unique abbreviation/short name of the location

This field is greyed out because it is an expandable field. You have to add $expand=Location in your request URI to get this field

": "{String}",
45
               "locationLink
LocationLink

Location reference

This field is greyed out because it is an expandable field. You have to add $expand=Location in your request URI to get this field

": "{String}"
46
          },
47
          "totals
Totals

This field is greyed out because it is an expandable field. You have to add $expand=Totals in your request URI to get this field

": {
48
               "acceptedRisksCount
AcceptedRisksCount

Count of accepted risks that belong to this risk assessment

This field is greyed out because it is an expandable field. You have to add $expand=Totals in your request URI to get this field

": "{Integer}",
49
               "risksCount
RisksCount

Count of all risks that belong to this risk assessment

This field is greyed out because it is an expandable field. You have to add $expand=Totals in your request URI to get this field

": "{Integer}",
50
               "participantsCount
ParticipantsCount

Count of participants

This field is greyed out because it is an expandable field. You have to add $expand=Totals in your request URI to get this field

": "{Integer}",
51
               "actionsCount
ActionsCount

Number of actions related to this risk assessment

This field is greyed out because it is an expandable field. You have to add $expand=Totals in your request URI to get this field

": "{Integer}",
52
               "controlsCount
ControlsCount

Number of controls related to this risk assessment

This field is greyed out because it is an expandable field. You have to add $expand=Totals in your request URI to get this field

": "{Integer}"
53
          },
54
          "context
Context

This field is greyed out because it is an expandable field. You have to add $expand=Context in your request URI to get this field

": {
55
               "source
Source

This field is greyed out because it is an expandable field. You have to add $expand=Context in your request URI to get this field

": {
56
                    "objectId
ObjectId

Identifier of the object

This field is greyed out because it is an expandable field. You have to add $expand=Context in your request URI to get this field

": "{Integer}",
57
                    "objectType
ObjectType

Type of object

This field is greyed out because it is an expandable field. You have to add $expand=Context in your request URI to get this field

": "{String}",
58
                    "objectLink
ObjectLink

API reference to the object

This field is greyed out because it is an expandable field. You have to add $expand=Context in your request URI to get this field

": "{String}"
59
               }
60
          }
61
     }
62
}

Possible error codes the response might return:

Error 107643 HTTP 404 File folder not found