---
title: "Get the supplier no-signal bucket"
method: GET
path: "/suppliers/no-signal"
tags: ["Suppliers"]
---

# Get the supplier no-signal bucket

`GET /suppliers/no-signal`

## Request

- Base URL: `https://api.greentally.ai/v1`
- URL: `https://api.greentally.ai/v1/suppliers/no-signal`
- Auth: HTTP bearer

## Response `200`

Supplier no-signal bucket

- NoSignalSupplierBucketResponse
  - `data` NoSignalSupplierBucket, required
    - `recordCount` integer, 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
      - `entityId` string, nullable: The row's entity; set without siteId on an entity-only row.
      - `entityName` string, 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
      - `inScopeRawValue` number, double: rawValue's share inside the workspace's period, as inScopeValue; equals rawValue outside a period workspace. Set on supplier reads when rawValue is set; absent otherwise.
      - `inScopeSpendValue` number, double: spendValue's share inside the workspace's period, as inScopeValue; equals spendValue outside a period workspace. Set on supplier reads when spendValue is set; absent otherwise.
      - `inScopeValue` number, double: The record's share inside the workspace's period, in the unit of value: value times the share of the record's UTC days inside the period; equals the full value outside a period workspace. On a supplier detail, the part of that share inside an accepted supplier figure's period is the figure's share instead of the estimate (supplierProvidedValue). Set on supplier reads (supplier detail and no-signal records), whose totals sum it; absent elsewhere.
      - `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
      - `replacedEstimateKgCo2e` number, double: Set exactly when supplierProvidedKgCo2e is: the row's calculated estimate, in kgCO2e, that the supplier figure replaces (the covered days' part of `value`). The figure totals count for the row is `value` (in kgCO2e) − replacedEstimateKgCo2e + supplierProvidedKgCo2e. Absent otherwise.
      - `resource` string, nullable: Utility resource (electricity, natural_gas, diesel, ...); null until classified.
      - `scope` integer, nullable
      - `siteId` string, nullable: The site the row is stamped with; an archived site still shows on the rows it stamped.
      - `siteName` string, 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
      - `supplierProvidedKgCo2e` number, double: With SUPPLIER_FIGURES_IN_TOTALS on: the row's supplier-provided share in kgCO2e, when an accepted supplier figure covers it (a Scope 3 row of that supplier with days inside the figure's period). `value` stays the calculated value; totals read value with this share in place of the estimate it replaces. Absent otherwise.
      - `supplierProvidedValue` number, double: The part of inScopeValue that is supplier-provided, in the unit of value. Set only on supplier detail records with days inside an applied supplier figure's period; absent otherwise.
      - `unit` string, required
      - `usage` string, nullable: Utility usage (building, vehicle, unassigned or other); null until classified.
      - `value` number, double, required
    - `totalEmissionsKgCo2e` number, double, required
    - `unrecognisedUnitRecordCount` integer, required: The records (of recordCount) whose emission unit is not a known mass (g, kg, t, lb, short ton, long ton, with or without a CO2 suffix); they are not in totalEmissionsKgCo2e ("convert known, exclude rest", 2026-10-09).
  - `meta` object

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-10-11** `74b67002e593`: 1 info
  - added the required property `data/unrecognisedUnitRecordCount` to the response with the `200` status
- **2026-10-09** `840a458f7a4d`: 1 info
  - added the optional property `data/records/items/replacedEstimateKgCo2e` to the response with the `200` status
- **2026-10-05** `04eabb8ebb47`: 5 info
  - added the optional property `data/records/items/inScopeRawValue` to the response with the `200` status
  - added the optional property `data/records/items/inScopeSpendValue` to the response with the `200` status
  - added the optional property `data/records/items/inScopeValue` to the response with the `200` status
  - added the optional property `data/records/items/supplierProvidedKgCo2e` to the response with the `200` status
  - …1 more
- **2026-10-02** `766c2a40e369`: 4 info
  - added the optional property `data/records/items/entityId` to the response with the `200` status
  - added the optional property `data/records/items/entityName` to the response with the `200` status
  - added the optional property `data/records/items/siteId` to the response with the `200` status
  - added the optional property `data/records/items/siteName` to the response with the `200` status
- **2026-10-01** `b4751fd15397`: 2 info
  - added the optional property `data/records/items/resource` to the response with the `200` status
  - added the optional property `data/records/items/usage` to the response with the `200` status

[Operation history](https://skmtc.dev/greentally/apis/esgai-api/changes/suppliers/no-signal/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/7eab940f1dd0?raw)