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
1URN. - Maximum of
50URNs 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
suggestionsarray. - 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.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Request payload containing one or more URNs that should be resolved into price suggestions.
Collection of URNs to retrieve price suggestions for.
1 - 50 elements[^/]$Response
Price suggestions stored for the provided URNs
Response payload containing the price suggestions associated with the URNs provided in the request.
Price suggestions retrieved from the KV store. Suggestions are only returned for URNs that exist in the store.