Skip to content

Get Offer

Request

Look up a single offer by its ID. To look up many offers in one round trip, use POST /offers/bulk instead.

See OfferResponse for the full concept and shape of an offer.

Security
BearerAuth
Path
idstringrequired

The offer's colon-separated identifier (e.g. PublicOffTheShelf:550e8400-e29b-41d4-a716-446655440000). This is the same value as offer_id returned by other endpoints such as GET /sourcing-scenarios/{id}/purchase-options. Treat as an opaque string.

Headers
Acceptstring(OfferAcceptHeader)required

Set this to application/api.luminovo.offer-v1+json.

Value:"application/api.luminovo.offer-v1+json"
GET
/offers/{id}
curl -i -X GET \
  'https://api.luminovo.com/offers/{id}' \
  -H 'Accept: application/api.luminovo.offer-v1+json' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Successfully retrieved offer.

Bodyapplication/json
One of:

An offer for a catalog part. availability (stock + factory lead time) is reported at the offer level. Price-break tiers carry only quantity and unit price. linked_part.type is OffTheShelf or InternalPartNumber.

idstringrequired

The offer's unique identifier in the opaque colon-separated form <kind>:<uuid> (e.g. PublicOffTheShelf:550e8400-...). Treat this value as an opaque string — its internal structure may change.

Example:"PublicOffTheShelf:550e8400-e29b-41d4-a716-446655440000"
linked_partOffTheShelf (object) or (InternalPartNumber (ComponentLite (object) or CustomComponentLite (object)))(StandardPartOfferLinkedPart)required
Example:
{
  "type": "OffTheShelf",
  "id": "OffTheShelf:a1b2c3d4-5678-90ab-cdef-123456789012",
  "mpn": "RC0402FR-0710KL",
  "manufacturer": {
    "id": "c3d4e5f6-7890-12ab-cdef-345678901234",
    "name": "Yageo"
  }
}
One of:

A catalog (off-the-shelf) part identified by manufacturer + MPN.

linked_locationSupplier (object) or InventorySite (object)(LinkedLocation)required
Example:
{
  "type": "Supplier",
  "id": "f1a2b3c4-0000-1111-2222-333344445555",
  "name": "Mouser Electronics",
  "number": "SUP-001",
  "stock_location": {
    "id": 150,
    "name": "Europe"
  }
}
One of:

An external supplier branch (e.g. Mouser Europe, Arrow Asia, Digi-Key, or a direct manufacturer).

unit_of_measurementWeight (object) or Length (object) or Volume (object) or Number (object)(Quantity)required
Example:
{
  "type": "Number",
  "unit": "Pieces",
  "value": "1"
}
One of:

A weight, with unit taken from WeightUnit (e.g. Kilograms, Grams, Milligrams, Pounds).

supplier_part_numberstringrequired

The supplier's own part number for this item (sometimes called "SPN" or "vendor part number"). May differ from the manufacturer part number. null if the supplier didn't provide one.

Example:"603-RC0402FR-0710KL"
offer_numberstring or null

The supplier's quote or offer reference number — typically from their RFQ / quotation system (e.g. "QUO-2026-1234"). Useful when reconciling against the supplier's own records. null if the offer has no associated quote reference (e.g. a list-price entry).

Example:"QUO-2026-1234"
price_typenull or string
Example:"ListPrice"
One of:

The type of pricing this offer represents — e.g. list price (open catalog price), contract price (negotiated long-term agreement), quote price (one-off RFQ response), or customer-negotiated price. Always present for standard-part offers.

null
price_breaksArray of objects(StandardPartPriceBreak)required

Quantity-based pricing tiers, each carrying quantity + unit price. Quantities and prices are in offer units. The order of tiers is not guaranteed — clients should sort by minimum_order_quantity if order matters.

Example:
[
  {
    "minimum_order_quantity": 1,
    "minimum_packaging_quantity": 1,
    "unit_price": { … }
  },
  {
    "minimum_order_quantity": 1000,
    "minimum_packaging_quantity": 100,
    "unit_price": { … }
  }
]
one_time_costsArray of objects(types.sourcing.sourcing_scenario.v1.OneTimeCost)required

Non-recurring costs associated with this offer (e.g. tooling, NRE, setup fees). Empty array if none.

Example:
[]
packagingnull or string
Example:"Reel"
One of:

Packaging the part ships in (e.g. Reel, Tape, Tray, Tube, AmmoPack, Bag, Bulk). null means the supplier did not specify packaging.

null
availabilitynull or object
Example:
{
  "factory_lead_time": {
    "unit": "Weeks",
    "value": 12
  },
  "factory_quantity": 100000,
  "stock": {
    "type": "Number",
    "unit": "Pieces",
    "value": "5000"
  }
}
One of:

Stock on hand and factory lead-time at the offer level. null if the supplier did not report any availability information.

null
valid_fromstring, (date)required

Start of the offer's validity window. null means the offer has no explicit start date and is considered valid from creation. Date only, no timezone.

Example:"2026-01-15"
valid_untilstring, (date)required

End of the offer's validity window — after this date the offer should no longer be honoured. null means the offer has no explicit expiry. Date only, no timezone.

Example:"2026-06-15"
cancellation_policynull or object
Example:null
One of:

Terms governing cancellation and returns once an order has been placed against this offer: the time window during which the order can still be cancelled, plus an optional non-cancellable / non-returnable (NCNR) flag. null if the supplier did not specify these terms.

null
notesstring or null

Free-text notes about the offer (e.g. "Lead-free variant", "EOL announced — last-time-buy only").

Example:"Lead-free variant"
creation_datestring, (date-time)required

When this offer was first created in Luminovo (ISO 8601 with timezone).

Example:"2026-01-15T10:30:00Z"
kindstringrequired
Value:"StandardPart"
Example:"StandardPart"
Response
{
  "kind": "StandardPart",
  "id": "PublicOffTheShelf:550e8400-e29b-41d4-a716-446655440000",
  "linked_part": {
    "type": "OffTheShelf",
    "id": "OffTheShelf:a1b2c3d4-5678-90ab-cdef-123456789012",
    "mpn": "RC0402FR-0710KL",
    "manufacturer": { … }
  },
  "linked_location": {
    "type": "Supplier",
    "id": "f1a2b3c4-0000-1111-2222-333344445555",
    "name": "Mouser Electronics",
    "number": "SUP-001",
    "stock_location": { … }
  },
  "unit_of_measurement": {
    "type": "Number",
    "unit": "Pieces",
    "value": "1"
  },
  "supplier_part_number": "603-RC0402FR-0710KL",
  "offer_number": "QUO-2026-1234",
  "price_type": "ListPrice",
  "price_breaks": [
    { … },
    { … }
  ],
  "one_time_costs": [],
  "packaging": "Reel",
  "availability": {
    "factory_lead_time": { … },
    "factory_quantity": 100000,
    "stock": { … }
  },
  "valid_from": "2026-01-15",
  "valid_until": "2026-06-15",
  "cancellation_policy": null,
  "notes": "Lead-free variant",
  "creation_date": "2026-01-15T10:30:00Z"
}