---
title: "Conversions BOM lines needed and the table lacks (Greentally staff only)"
method: GET
path: "/internal/pcf/conversion-gaps"
tags: ["PlatformOps"]
---

# Conversions BOM lines needed and the table lacks (Greentally staff only)

`GET /internal/pcf/conversion-gaps`

For every saved PCF line whose unit does not convert to its factor's unit and that no reviewed conversion row fits, grouped by item key, reference product and unit pair: how many lines, products and organizations need it, how many were resolved only by a value a user typed (a typed value that no longer fits is not counted), and where it stands: needs_sourcing; awaiting_approval; awaiting_choice when the table covers it but its lines hold a stored choice that no longer fits (only those lines are counted, since the others resolve by default); or unsupported when no conversion row could close it (an unknown unit, a pair outside the table's units, or no subject). Lines with no usable factor are counted by unit. Units the calculator does not know are reported as "unknown". Counts only; no line text. Feeds the conversion sourcing workflow. Requires a Greentally platform capability.

## Response `200`

The gap report

- PcfConversionGapsResponse
  - `data` object, required
    - `activeSetVersion` string, required
    - `gaps` PcfConversionGap[], required
      - `fromUnit` string, required — The lines' base unit, or the normalized spelling of a unit the calculator does not know.
      - `itemKey` string, required — The lines' item key, empty when they have none.
      - `lines` integer, required
      - `organizations` integer, required
      - `products` integer, required
      - `referenceProduct` string, required — The factors' ecoinvent reference product, empty when they have none.
      - `status` 'needs_sourcing' | 'awaiting_approval' | 'awaiting_choice' | 'unsupported', required
      - `toUnit` string, required
      - `userEntered` integer, required — Lines resolved only by a value a user typed.
    - `unmatchedByUnit` object[], required — Lines with no usable factor yet, by unit.
      - `lines` integer, required
      - `unit` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

## Changes

- **2026-10-06** `461a0ebc7731` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greentally/apis/esgai-api/changes/internal/pcf/conversion-gaps/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/461a0ebc7731?raw)