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   "object": "list",
3   "has_more": true,
4   "data": [
5     {
6       "business_snapshot_url": "https://api.middesk.com/v1/businesses/0793f2a2-e315-4b6a-9f0c-2d1e3c4b5a69?order_id=a58a4f4e-7f3b-4c8e-9d2a-1b0c9d8e7f6a",
7       "created_at": "2026-07-21T18:03:11Z",
8       "description_markdown": "Acme Home Goods presents as a small home furnishings retailer, but its storefront shows several traits common to laundering fronts.\n\n- The checkout flow displays no-refund language ([acmehomegoods.com/checkout](https://acmehomegoods.com/checkout))\n- The product catalog reuses stock imagery found on unrelated storefronts ([acmehomegoods.com/shop](https://acmehomegoods.com/shop))",
9       "dimensions": [
10         {
11           "object": "risk_dimension",
12           "type": "transaction_laundering",
13           "score": 0.72,
14           "level": "high",
15           "top_factors": [
16             {
17               "name": "website_has_no_refund_language",
18               "type": "boolean",
19               "value": true,
20               "contribution": 0.28
21             },
22             {
23               "name": "url_risk_score",
24               "type": "double",
25               "value": 0,
26               "contribution": -0.17
27             }
28           ]
29         }
30       ],
31       "id": "5f8c9d0e-1a2b-4c3d-8e9f-6a7b8c9d0e1f",
32       "identifier_assessments": [
33         {
34           "object": "email_risk",
35           "id": "idr_9f3c2a71e4b8d605",
36           "resource": {
37             "type": "email_address",
38             "id": "e7a8b9c0-d1e2-4f3a-8b4c-5d6e7f8a9b0c",
39             "value": "[email protected]"
40           },
41           "score": 0.81,
42           "attributes": [
43             {
44               "name": "email_is_valid",
45               "type": "boolean",
46               "value": true
47             },
48             {
49               "name": "email_deliverability_low",
50               "type": "boolean",
51               "value": true
52             }
53           ]
54         }
55       ],
56       "level": "high",
57       "object": "risk_assessment",
58       "order_id": "a58a4f4e-7f3b-4c8e-9d2a-1b0c9d8e7f6a",
59       "score": 68,
60       "title": "Likely transaction laundering: the storefront cannot support its stated sales volume."
61     }
62   ],
63   "total_count": 1
64 }

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

objectstring

has_moreboolean

datalist of objectsOptional

total_countintegerOptional

Errors

403

Get Risk Assessments Request Forbidden Error

404

Get Risk Assessments Request Not Found Error