Skip to main content
POST
/
listings
/
seller
/
{id}
Search a seller's listings
curl --request POST \
  --url https://api.managem.co.uk/listings/seller/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "charizard",
  "from": 0,
  "size": 20
}
'
{
  "total": 1,
  "hits": [
    {
      "id": "lst_987",
      "sellerId": "sel_123",
      "condition": "LP",
      "price": 4500,
      "quantity": 1,
      "available": 1,
      "language": "English",
      "variants": [
        "Holo"
      ],
      "createdAt": "2026-03-02T12:00:00.000Z",
      "updatedAt": "2026-03-02T12:00:00.000Z",
      "item": {
        "urn": "urn:managem:pokemon:card/base2/4-charizard",
        "type": "card",
        "game": "Pokemon",
        "title": "Charizard",
        "name": "Charizard",
        "rarity": "Rare",
        "number": "4",
        "set": {
          "name": "Jungle",
          "urn": "urn:managem:pokemon:set/base2",
          "counts": {},
          "references": []
        },
        "series": {
          "name": "Base",
          "urn": "urn:managem:pokemon:series/base"
        },
        "images": [
          {
            "urn": "urn:managem:pokemon:image/base2-4",
            "orientation": "portrait",
            "url": "https://assets.managem.co.uk/images/base2-4.png"
          }
        ],
        "alternatives": [],
        "metadata": [],
        "slug": "/pokemon/card/base2/4-charizard"
      },
      "seller": {
        "id": "usr_222",
        "username": "vintagecards",
        "avatar": "https://assets.managem.co.uk/avatars/usr_222.png",
        "reviews": 87,
        "rating": 4.7,
        "score": 4.6,
        "sales": 302,
        "purchases": 41
      },
      "locked": false,
      "attachments": []
    }
  ],
  "facets": {
    "Condition": {
      "LP": 1
    }
  }
}

Path Parameters

id
string
required

User ID or username of the seller

Minimum string length: 1

Body

application/json

A search query includes a free text query property, refinements in the form of facets, pagination controls and optional sorting.

query
string

One or more free text search terms

filters
object[]
facets
object

Facets to refine the search results. Values are case-sensitive unless noted otherwise.

from
number | null
default:0

Offset for pagination

size
number
default:25

Number of results to return

Required range: 1 <= x <= 50
sorting
object

Sort results by field and order

Response

Seller listings

Result of a listings search query

total
number
required

Total number of results

hits
object[]
required

List of listings

facets
object
required

Facets that can be applied to further refine the search results