PriceLookup

Listing/retail price envelope (LIQ-1049). Default GET serves stored usedRetailUsd (else snapshot extract). force_refresh=true acquires via POST /v1/resolve lane=price. Never bestRouteFmvUsd.

  • asset_id
    Type: string
    required
  • currency
    enum
    const:  
    USD
    required
  • data_match
    Type: boolean
    required

    True when price_usd is a positive finite number.

  • identifier
    Type: string
    required
  • lane
    Type: string | null
    required

    Resolve lane (price for this API).

  • price_type
    enum
    const:  
    listing_retail
    required
  • schema_version
    Type: string
    required

    Contractual provenance schema (liq-1056-2).

  • as_of
    Type: string | nullFormat: date-time

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

  • assurance_markers
    Type: array of string | null
  • cache_hit
    Type: boolean | null

    true when the default GET served stored listing/retail USD, or engine durable replay after acquire.

  • data_age_seconds
    Type: integer | null

    Seconds since the latest CanonicalMarketPricingSnapshot write clock when this request loaded a snapshot row (extract fallback, vendor_raw, or post-acquire). Default GET with stored usedRetailUsd skips that table and returns null — the price-lane projector does not upsert it.

  • downgraded_from
    Type: object | null
    Properties: 2
  • grounding
    Type: string | null
  • iq_level
    Type: string | null

    Served IQ from the engine envelope when present; null on a stored DB serve without provenance.

  • listing_id
    Type: string | null
  • listing_slug
    Type: string | null

    Catalog slug of the held listing when the engine reports it.

  • message
    Type: string | null
  • no_match_reason
    Type: string | null

    NOT_ENRICHED when default GET finds no stored listing/retail. After acquire, NO_PRODUCT_MATCH or contractual miss reasons from the engine.

  • numeric_score
    Type: number | null
  • price_usd
    Type: number | null

    Listing/retail USD. Null when not stored or the acquire has no match.

  • retrieved_at
    Type: string | nullFormat: 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 price source slug (e.g. keepa, layer-iq-price).

  • vendor_raw

    Present when vendor_raw=true. Winning licensed-source observation JSON (Keepa snapshot JSON when Keepa won, else a market_pricing observation, else this request’s live engine payload), or source/payload null with a message when none exists. Omitted when the query flag is false.

    Present when vendor_raw=true. Winning licensed-source observation JSON (Keepa snapshot JSON when Keepa won, else a market_pricing observation, else this request’s live engine payload), or source/payload null with a message when none exists. Omitted when the query flag is false.

    • domain
      Type: string
      required
    • payload
      Type: object
      required
      Properties: 1
    • retrieved_at
      Type: stringFormat: 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 of the winning price-lane source.