Search listings for an item

POST

/listings/item

Retrieve listings for a specific item by URN or slug.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢200OK

application/json

Listings for the item

Body

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.managem.co.uk/listings/item' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "query": "string",
    "filters": [
        {
            "property1": null,
            "property2": null
        }
    ],
    "facets": {
        "property1": [
            "string"
        ],
        "property2": [
            "string"
        ]
    },
    "from": 0,
    "size": 25,
    "sorting": {
        "field": "name",
        "order": "asc"
    },
    "urn": "urn:managem:pokemon:product/pop8/pop-series-8-pack-4c899e14",
    "slug": "/pokemon/product/pop8/pop-series-8-pack-4c899e14"
}'

Response Example

{
    "total": 0,
    "hits": [
        {
            "id": "string",
            "sellerId": "string",
            "condition": "string",
            "price": 0,
            "quantity": 1,
            "available": 0,
            "language": "string",
            "variants": [],
            "comment": "string",
            "gradingProvider": "string",
            "gradingScore": "string",
            "gradingNumber": "string",
            "createdAt": "string",
            "updatedAt": "string",
            "item": {
                "urn": "string",
                "type": "card",
                "game": "Pokemon",
                "title": "string",
                "name": "string",
                "rarity": "string",
                "number": "string",
                "description": "string",
                "set": {
                    "name": "string",
                    "size": 0,
                    "urn": "string",
                    "counts": {
                        "printed": 0,
                        "total": 0
                    },
                    "symbol": {
                        "url": "string"
                    },
                    "released": "string",
                    "references": [
                        "string"
                    ]
                },
                "series": {
                    "name": "string",
                    "urn": "string"
                },
                "images": [
                    {
                        "urn": "string",
                        "illustrator": "string",
                        "url": "http://example.com"
                    }
                ],
                "alternatives": [
                    "string"
                ],
                "metadata": [
                    {
                        "name": "string",
                        "value": "string",
                        "detail": null
                    }
                ],
                "price": 0,
                "available": 0,
                "quantity": 0,
                "min": {
                    "id": "string",
                    "sellerId": "string",
                    "price": 0
                },
                "max": {
                    "id": "string",
                    "sellerId": "string",
                    "price": 0
                }
            },
            "seller": {
                "id": "string",
                "username": "string",
                "avatar": "http://example.com",
                "cover": "http://example.com",
                "profile": "string",
                "reviews": 0,
                "rating": 0,
                "score": 0,
                "sales": 0,
                "purchases": 0
            },
            "locked": true,
            "attachments": []
        }
    ],
    "facets": {
        "property1": {
            "property1": 0,
            "property2": 0
        },
        "property2": {
            "property1": 0,
            "property2": 0
        }
    }
}

Search all listings

Retrieve historical prices for an item