Skip to main content
POST
/
listings
curl --request POST \
  --url https://api.managem.co.uk/listings \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "pikachu",
  "from": 0,
  "size": 10
}
'
{
  "total": 1,
  "hits": [
    {
      "id": "lst_123",
      "sellerId": "sel_456",
      "condition": "NM",
      "price": 1299,
      "quantity": 2,
      "available": 2,
      "language": "English",
      "variants": [],
      "createdAt": "2026-03-01T12:00:00.000Z",
      "updatedAt": "2026-03-01T12:00:00.000Z",
      "item": {
        "urn": "urn:managem:pokemon:card/base1/58-pikachu",
        "type": "card",
        "game": "Pokemon",
        "title": "Pikachu",
        "name": "Pikachu",
        "rarity": "Common",
        "number": "58",
        "set": {
          "name": "Base Set",
          "urn": "urn:managem:pokemon:set/base1",
          "counts": {},
          "references": []
        },
        "series": {
          "name": "Base",
          "urn": "urn:managem:pokemon:series/base"
        },
        "images": [
          {
            "urn": "urn:managem:pokemon:image/base1-58",
            "orientation": "portrait",
            "url": "https://assets.managem.co.uk/images/base1-58.png"
          }
        ],
        "alternatives": [],
        "metadata": [],
        "slug": "/pokemon/card/base1/58-pikachu"
      },
      "seller": {
        "id": "usr_789",
        "username": "cardsmith",
        "avatar": "https://assets.managem.co.uk/avatars/usr_789.png",
        "reviews": 120,
        "rating": 4.9,
        "score": 4.8,
        "sales": 540,
        "purchases": 83
      },
      "locked": false,
      "attachments": []
    }
  ],
  "facets": {
    "Game": {
      "Pokemon": 1
    },
    "Condition": {
      "NM": 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

200 - application/json

Search results

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