---
title: "Suggest listing prices"
method: POST
path: "/seller/listings/suggest"
tags: ["seller-listings"]
---

# Suggest listing prices

`POST /seller/listings/suggest`

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.

## Request body

- SellerListingSuggestionRequest — Request payload containing one or more URNs that should be resolved into price suggestions.
  - `urns` string[], required — Collection of URNs to retrieve price suggestions for.

## Response `200`

Price suggestions stored for the provided URNs

- SellerListingSuggestionResponse — Response payload containing the price suggestions associated with the URNs provided in the request.
  - `suggestions` SellerListingSuggestion[], required — Price suggestions retrieved from the KV store. Suggestions are only returned for URNs that exist in the store.
    - `default` integer, required — Suggested listing price for a normal copy stored as the lowest denomination (for example, pennies).
    - `holo` integer — Suggested listing price for a holo/foil copy stored as the lowest denomination (for example, pennies).
    - `urn` string, required — URN identifying the item the price suggestion applies to.

## Other responses

- `401` — Seller not active
- `404` — Seller not found

---

[API](https://skmtc.net/managem/apis/managem-api.md) · [All operations](https://skmtc.net/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/managem/managem-api/revisions/e8d78a3a2e8b/schema)