Retrieve a business's risk assessment history

GET

https://api.middesk.com/v1/businesses/:business_id/risk_assessments

GET

/v1/businesses/:business_id/risk_assessments

$ curl https://api.middesk.com/v1/businesses/business_id/risk_assessments \
>      -H "Authorization: Bearer <token>"

1 {
2   "data": [
3     {
4       "business_snapshot_url": "https://api.middesk.com/v1/businesses/a1b2c3d4-e5f6-7890-abcd-ef1234567890?order_id=f6a7b8c9-0123-4567-89ab-cdef01234567",
5       "created_at": "2026-06-01T12:00:00.000Z",
6       "findings": [
7         {
8           "confidence": "strong",
9           "deliverability": "deliverable",
10           "disposable": false,
11           "honeypot": false,
12           "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
13           "leaked": false,
14           "level": "low",
15           "type": "email_address",
16           "valid": true,
17           "value": "[email protected]"
18         },
19         {
20           "confidence": "moderate",
21           "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
22           "leaked": false,
23           "level": "low",
24           "line_type": "mobile",
25           "prepaid": false,
26           "type": "phone_number",
27           "valid": true,
28           "value": "+14155551234",
29           "voip": false
30         },
31         {
32           "confidence": "moderate",
33           "dmarc_record": false,
34           "domain_created_at": "2015-03-14T00:00:00.000Z",
35           "domain_registrar": "Example Registrar, LLC",
36           "domain_trust": "established",
37           "hosting_country": "US",
38           "id": "d4e5f6a7-b8c9-0123-def1-234567890123",
39           "level": "moderate",
40           "malware_detected": false,
41           "parking_detected": false,
42           "phishing_detected": false,
43           "spf_record": true,
44           "tls_supported": true,
45           "type": "website",
46           "value": "https://www.example.com"
47         }
48       ],
49       "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
50       "level": "moderate",
51       "object": "risk_assessment",
52       "order_id": "f6a7b8c9-0123-4567-89ab-cdef01234567"
53     }
54   ],
55   "object": "list"
56 }

Authentication

AuthorizationBearer

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

Path parameters

business_idstringRequired

Business ID

Query parameters

order_idstringOptional

Filter to assessments produced against a single order

Response

risk assessments

Errors

403

Get Risk Assessments Request Forbidden Error