Middesk APIRisk Assessments

Retrieve a risk assessment

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

business_idstringRequired
Business ID
idstringRequired
Risk Assessment ID

Response

risk assessment found
business_snapshot_urlstring or nullformat: "uri"

URL of the business as of this assessment’s order (GET /businesses/{id}?order_id={order_id}), resolving to the per-order snapshot to compare against the assessment’s findings. Null for assessments not tied to an order.

created_atdatetime
findingslist of objects

Point-in-time per-resource findings produced by this assessment. Each element is typed by type (email_address | phone_number | website).

idstringformat: "uuid"
levelenum

Categorical risk verdict. not_available means a Risk order ran but could not produce a conclusive verdict. New values are not expected; level is a closed set.

objectenum
order_idstring or nullformat: "uuid"

The order this assessment was produced against — the snapshot coordinate. Fetch the business as of this order with GET /businesses/{id}?order_id={order_id} to compare the assessment’s findings against the underlying record. Null for assessments not tied to an order.

Errors

403
Get Risk Assessment Request Forbidden Error
404
Get Risk Assessment Request Not Found Error