CarbonLookup

Carbon resolve envelope (LIQ-1032). One engine pull, one or more category slices. Default GET .../carbon (no categories query) returns every entitled slice: buyer cat2/cat5 and OEM cat11/cat12.

  • asset_id
    Type: string
    required
  • categories
    Type: array object[] · CarbonCatSlice[]
    required

    One GHG carbon field from a cached e.product+ payload (LIQ-1032).

    • category
      Type: string enum
      required

      GHG slice label. cat2 and cat5 are the buyer (ITAD / asset owner) lens; cat11 and cat12 are the OEM (sold-product) lens. Cat 11 uses the same manufacturing kg as Cat 2; Cat 12 uses the same end-of-life kg as Cat 5.

      values
      • cat2
      • cat5
      • cat11
      • cat12
    • field
      Type: string enum
      required
      values
      • manufacturing_kg_co2_eq
      • refurbishment_impact_kg_co2_eq
      • end_of_life_kg_co2_eq
    • data_match
      Type: boolean | null
    • data_method
      Type: string | null enum

      Layer IQ LCA specificity (CA category average, CA+ category average with extra attributes, MS manufacturer/model-specific product LCA). Same codes as Rejoose; other carbon sources map into this enum. Null when the source does not report a method.

      values
      • CA
      • CA+
      • MS
      • null
    • kg_co2_eq
      Type: number | null
    • product_match
      Type: boolean | null
    • refurbished
      Type: boolean | null
    • source
      Type: string | null enum
      values
      • manufacturing
      • refurbishment
      • null
  • identifier
    Type: string
    required
  • assurance_markers
    Type: array string[] | null

    Assurance markers on the winning source (e.g. EY_AUDIT).

  • grounding
    Type: string | null

    How the value is grounded (e.g. ASSURED).

  • iq_level
    Type: string | null

    Served IQ from the engine (IQ_5 for Rejoose, IQ_1 for heuristic fallback).

  • numeric_score
    Type: number | null
  • retrieved_at
    Type: string | null Format: date-time

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • source_slug
    Type: string | null

    Licensed carbon source slug (e.g. rejoose).

  • vendor_raw

    Present when vendor_raw=true. Either the winning licensed-source observation (or this request’s live e.product value.raw when no row is stored), or source/payload null with a message when none exists. Omitted when the query flag is false. Error bodies never include this field or vendor names.

    Present when vendor_raw=true. Either the winning licensed-source observation (or this request’s live e.product value.raw when no row is stored), or source/payload null with a message when none exists. Omitted when the query flag is false. Error bodies never include this field or vendor names.

    • domain
      Type: string
      required
    • payload
      Type: object
      required

      Vendor-shaped JSON stored on AssetSourceObservation.

    • retrieved_at
      Type: string Format: date-time
      required

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • source
      Type: string
      required

      SourceRegistration slug (e.g. rejoose).