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

# Suggest listing prices

`POST /seller/listings/suggest`

## Request

- Base URL: `https://api.managem.co.uk`
- URL: `https://api.managem.co.uk/seller/listings/suggest`
- Auth: HTTP bearer

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.dev/managem/apis/managem-api.md) · [All operations](https://skmtc.dev/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc.dev/managem/apis/managem-api/revisions/3a4470b55521?raw)