Middesk APIRisk Assessments

Retrieve the latest scored risk assessment for a business

Authentication

AuthorizationBearer

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

Path parameters

business_idstringRequired
Business ID

Response

latest risk assessment
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 Latest Risk Assessment Request Forbidden Error
404
Get Latest Risk Assessment Request Not Found Error