v14

OpenAPI 3.1.02026-08-03122113375.9 KB
seller-listings

Suggest listing prices

Retrieve stored price suggestions for one or more item URNs.

Use this endpoint to prefill listing prices in seller tooling before creating listings.

Request limits:

  • Minimum of 1 URN.
  • Maximum of 50 URNs per request.
  • Duplicate URNs are deduplicated before lookup.

Response behavior:

  • Suggestions are returned only for URNs that exist in the price suggestion store.
  • Missing URNs are silently omitted from the suggestions array.
  • Prices are integer values in the lowest denomination (for example, pennies), not floating point values.

Authentication and availability:

  • Caller must be an active seller.
  • The backing price suggestion store must be configured in the runtime environment.

Data quality handling:

  • Stored suggestion payloads are runtime-validated.
  • Invalid stored records are ignored and reported internally; valid records continue to be returned.
post/seller/listings/suggest

Request body

urnsstring[] required

Collection of URNs to retrieve price suggestions for.

Response

Price suggestions stored for the provided URNs