PriceLookup

Price envelope (LIQ-1049 + LIQ-1212). Default GET serves canonical pricing.usedRetailUsd, else Asset.usedRetailUsd, else snapshot extract. force_refresh=true acquires via POST /v1/resolve lane=price. Never bestRouteFmvUsd. used_retail + gaps are always present. price_usd equals used_retail.value_usd when present.

asset_id
Type: string
required
currency
Type: string | null
required

Same string as used_retail.currency. Null on a miss.
data_match
Type: boolean
required

True when price_usd is a positive finite number.
gaps
Type:
required
Properties: 3
identifier
Type: string
required
lane
Type: string | null
required

Resolve lane (price for this API).
price_type
Type: string | nullenum
required

Honest type for the dollar that won. Canonical dollars use stored pricing.priceType, the correlated observation domain, or Keepa mode. Snapshot extract and an unlabeled Asset scalar are null. Never hard-coded.

values
soldlisting_retailblendnull
schema_version
Type: string
required

Contractual provenance schema (liq-1056-2).
used_retail
Type:
required

Canonical used-retail slot (LIQ-1212 / CANONICAL-READ-CONTRACT §4).

Properties: 9
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

Same dollar as used_retail.value_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). Null when the dollar is only a legacy snapshot or an unlabeled Asset scalar. Never the synthetic legacy_snapshot token.
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.

PriceGap

IngestAssetInput