---
title: "Get a resolved supplier detail read model"
method: GET
path: "/suppliers/{supplierId}"
tags: ["Suppliers"]
---

# Get a resolved supplier detail read model

`GET /suppliers/{supplierId}`

## Path parameters

- `supplierId` string, required

## Response `200`

Supplier detail read model

- SupplierDetailResponse
  - `data` SupplierDetail, required
    - `records` CanonicalEmissionItem[], required
      - `activityType` string, nullable
      - `amountUnit` string, nullable
      - `categoryName` string, nullable
      - `createdAt` string, date-time, required
      - `description` string, nullable
      - `editable` boolean, required
      - `endDate` string, date-time, nullable
      - `factorArchived` boolean, required — True when the linked factor entry was archived after this emission was created.
      - `factorDisplayName` string, nullable
      - `factorEntryId` string, nullable
      - `factorLibraryId` string, nullable
      - `factorProvenance` CanonicalFactorProvenance
      - `factorReleaseId` string, nullable
      - `factorValue` number, double, nullable
      - `id` string, required
      - `isCarbon` boolean, required
      - `locationDisplay` string, nullable
      - `locationId` string, nullable
      - `metricKind` 'emission_output', required
      - `name` string, required
      - `origin` 'template' | 'direct_upload', required
      - `provenanceStatus` 'authoritative', required
      - `rawValue` number, double, nullable
      - `scope` integer, nullable
      - `sourceFile` CanonicalEmissionSourceFile
        - `contentType` string, nullable
        - `fileName` string, required
        - `uploadId` string, required
      - `sourceRecordId` string, nullable
      - `sourceType` string, required
      - `spendCurrency` string, nullable
      - `spendValue` number, double, nullable
      - `startDate` string, date-time, required
      - `subCategoryName` string, nullable
      - `supplierDisplay` string, nullable
      - `supplierId` string, nullable
      - `unit` string, required
      - `value` number, double, required
    - `sourceEvidence` SupplierSourceEvidence[], required
      - `provenanceStatus` 'authoritative', required
      - `recordCount` integer, required
      - `sourceType` string, required
      - `totalEmissionsKgCo2e` number, double, required
    - `supplier` SupplierSummary, required
      - `intensityByCurrency` SupplierIntensityTotal[], required
        - `currency` string, required
        - `kgCo2ePerUnit` number, double, required
      - `methodMix` SupplierMethodMixItem[], required
        - `method` 'activity_based' | 'spend_based', required
        - `recordCount` integer, required
        - `totalEmissionsKgCo2e` number, double, required
      - `name` string, required
      - `recordCount` integer, required
      - `spendByCurrency` SupplierSpendTotal[], required
        - `amount` number, double, required
        - `currency` string, required
      - `supplierId` string, required
      - `totalEmissionsKgCo2e` number, double, required
  - `meta` object

## Other responses

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

---

[API](https://skmtc.dev/greentally/apis/esgai-api.md) · [All operations](https://skmtc.dev/greentally/apis/esgai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greentally/esgai-api/revisions/4fccdcaa5e57/schema)