---
title: "Get a supplier risk read model assembled from profile facts"
method: GET
path: "/suppliers/{supplierId}/risk"
tags: ["Suppliers"]
---

# Get a supplier risk read model assembled from profile facts

`GET /suppliers/{supplierId}/risk`

## Path parameters

- `supplierId` string, required

## Response `200`

Supplier risk detail

- SupplierRiskDetailResponse
  - `data` SupplierRiskDetail, required
    - `confidence` string, required — high, medium, or low.
    - `dimensions` SupplierRiskDimensionDetail[], required
      - `dimension` string, required — esg_status, environment, country_risk, or recent_news.
      - `evidence` 'web' | 'dataset' | 'knowledge' | 'unavailable', required — Which tier produced this dimension. web means it was checked against retrieved pages, dataset means a deterministic offline lookup, knowledge means model recall with nothing retrieved to check it against, and unavailable means it was never answered — including facts stored before this field existed. web and dataset are distinct: a dataset attribution URL in sources says nothing about whether the web was ever consulted.
      - `level` string, required
      - `sources` string[], required
      - `summary` string, required
    - `humanReview` boolean, required
    - `level` string, required — Overall risk level, one of very-low, low, medium, high, very-high.
    - `researchedAt` string, date-time
    - `supplierId` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

## Changes

- **2026-09-28** `578e1527454e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greentally/apis/esgai-api/changes/suppliers/:supplierId/risk/get.md)

---

[API](https://skmtc.dev/greentally/apis/esgai-api.md) · [All operations](https://skmtc.dev/greentally/apis/esgai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/greentally/apis/esgai-api/revisions/578e1527454e?raw)