Third-party integration reference for this listing
Maximum string length: 255
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"docs","colors":{"primary":"#927dff","light":"#927dff","dark":"#927dff"},"logo":{"light":"https://mintcdn.com/managem/JwthiBp-Ca5zDncq/logo/logo.svg?fit=max\u0026auto=format\u0026n=JwthiBp-Ca5zDncq\u0026q=85\u0026s=781554ca2edef422e6d5522cec6abe6f","dark":"https://mintcdn.com/managem/JwthiBp-Ca5zDncq/logo/logo.svg?fit=max\u0026auto=format\u0026n=JwthiBp-Ca5zDncq\u0026q=85\u0026s=781554ca2edef422e6d5522cec6abe6f"},"favicon":"/logo/logo.svg","navbar":{"links":[{"href":"mailto:support@managem.co.uk","label":"Support"}],"primary":{"type":"button","label":"Marketplace","href":"https://managem.co.uk"}},"footer":{"socials":{"discord":"https://discord.gg/qaU4KSEQRd"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Documentation","icon":"book","href":"https://docs.managem.co.uk"},{"anchor":"Connect AI","icon":"bot","href":"/mcp"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"managem","hasAudioNarration":false,"actualSubdomain":"managem","customDomains":["docs.managem.co.uk"],"gitSource":{"type":"github","owner":"managemco","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21ec1bfb57cfb9e9a7a3bf","collectionId":"4ff6f1e9-0826-44a0-ba21-388ed56861cb","schemaVersion":"v2"},"entitlements":{},"buildId":"6a21ec1bfb57cfb9e9a7a3bf:success","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"default","tag":"Sellers","count":62},{"language":"default","tag":"Buyers","count":58},{"language":"default","tag":"Marketplace","count":26},{"language":"default","tag":"Account","count":17},{"language":"default","tag":"Management","count":17},{"language":"default","tag":"Listings","count":15},{"language":"default","tag":"Search","count":12},{"language":"default","tag":"Cases","count":12},{"language":"default","tag":"Webhooks","count":12},{"language":"default","tag":"Conversations","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/seller-listings/list-listings-by-item","slug":"/api-reference/seller-listings/list-listings-by-item","pageMetadata":{"title":"List listings by item","description":"\nList the authenticated seller's active listings for a specific item URN.\n\nThis endpoint is useful for item-centric listing management screens where a seller wants all of their offers for one product.\n\nQuery and ownership rules:\n- Requires `urn` query parameter.\n- Returns only listings owned by the authenticated seller.\n- Returns only listings with `quantity > 0` (active listings).\n\nData sources:\n- Listing rows are loaded from the primary database.\n- Item metadata is enriched from the catalog search index.\n- Listing lock state is derived from listing hold records.\n- Attachment URLs are attached to each listing in the response.\n\nResponse notes:\n- If no active listings exist for the provided URN, the API returns an empty array.\n- The `available` quantity in this response mirrors listing quantity.\n","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/listings/items","href":"/api-reference/seller-listings/list-listings-by-item","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"List the authenticated seller’s active listings for a specific item URN.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"This endpoint is useful for item-centric listing management screens where a seller wants all of their offers for one product.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Query and ownership rules:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [\"Requires \", _jsx(_components.code, {\n children: \"urn\"\n }), \" query parameter.\"]\n }), \"\\n\", _jsx(_components.li, {\n children: \"Returns only listings owned by the authenticated seller.\"\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Returns only listings with \", _jsx(_components.code, {\n children: \"quantity > 0\"\n }), \" (active listings).\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Data sources:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Listing rows are loaded from the primary database.\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Item metadata is enriched from the catalog search index.\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Listing lock state is derived from listing hold records.\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Attachment URLs are attached to each listing in the response.\"\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Response notes:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"If no active listings exist for the provided URN, the API returns an empty array.\"\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"The \", _jsx(_components.code, {\n children: \"available\"\n }), \" quantity in this response mirrors listing quantity.\"]\n }), \"\\n\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List listings by item","description":"\nList the authenticated seller's active listings for a specific item URN.\n\nThis endpoint is useful for item-centric listing management screens where a seller wants all of their offers for one product.\n\nQuery and ownership rules:\n- Requires `urn` query parameter.\n- Returns only listings owned by the authenticated seller.\n- Returns only listings with `quantity > 0` (active listings).\n\nData sources:\n- Listing rows are loaded from the primary database.\n- Item metadata is enriched from the catalog search index.\n- Listing lock state is derived from listing hold records.\n- Attachment URLs are attached to each listing in the response.\n\nResponse notes:\n- If no active listings exist for the provided URN, the API returns an empty array.\n- The `available` quantity in this response mirrors listing quantity.\n","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/listings/items","href":"/api-reference/seller-listings/list-listings-by-item","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["seller-listings"],"operationId":"listSellerListingsByItem","summary":"List listings by item","description":"\nList the authenticated seller's active listings for a specific item URN.\n\nThis endpoint is useful for item-centric listing management screens where a seller wants all of their offers for one product.\n\nQuery and ownership rules:\n- Requires `urn` query parameter.\n- Returns only listings owned by the authenticated seller.\n- Returns only listings with `quantity > 0` (active listings).\n\nData sources:\n- Listing rows are loaded from the primary database.\n- Item metadata is enriched from the catalog search index.\n- Listing lock state is derived from listing hold records.\n- Attachment URLs are attached to each listing in the response.\n\nResponse notes:\n- If no active listings exist for the provided URN, the API returns an empty array.\n- The `available` quantity in this response mirrors listing quantity.\n","security":["e0c34db8-7365-4aa6-b3dc-13ef45ac48d5"],"parameters":["30d43036-ba31-4946-8d94-f1f81b815519"],"responses":{"200":"33d42cfe-44fc-470c-9762-fd54b301ba19"},"method":"get","type":"path","servers":["a1faa4d7-f526-41b5-8c48-d2be7d297f34"],"path":"/seller/listings/items","baseUrlOptions":["https://api.managem.co.uk"],"title":"List listings by item","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"30d43036-ba31-4946-8d94-f1f81b815519":{"schema":{"type":"string","description":"URN of the item to retrieve listings for","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"URN of the item to retrieve listings for","name":"urn","in":"query"}},"responses":{"33d42cfe-44fc-470c-9762-fd54b301ba19":{"description":"Listings for item","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].id","typeLabel":"string"},"sellerId":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].sellerId","typeLabel":"string"},"condition":{"type":"string","description":"Product condition","isRequired":true,"uniqueKey":"items.[INDEX].condition","typeLabel":"string"},"price":{"type":"integer","description":"Price in pence","isRequired":true,"uniqueKey":"items.[INDEX].price","typeLabel":"integer"},"language":{"type":"string","description":"Languages of the card","isRequired":true,"uniqueKey":"items.[INDEX].language","typeLabel":"string"},"createdAt":{"oneOf":[{"type":"string","description":"Timestamp when the listing was created","isRequired":true,"uniqueKey":"items.[INDEX].createdAt.oneOf.0","typeLabel":"string"},{"type":"string","description":"Timestamp when the listing was created","format":"date-time","isRequired":true,"uniqueKey":"items.[INDEX].createdAt.oneOf.1","typeLabel":"string\u003cdate-time>"}],"isRequired":true,"uniqueKey":"items.[INDEX].createdAt","typeLabel":"string | string\u003cdate-time>"},"updatedAt":{"oneOf":[{"type":"string","description":"Timestamp when the listing was last updated","isRequired":true,"uniqueKey":"items.[INDEX].updatedAt.oneOf.0","typeLabel":"string"},{"type":"string","description":"Timestamp when the listing was last updated","format":"date-time","isRequired":true,"uniqueKey":"items.[INDEX].updatedAt.oneOf.1","typeLabel":"string\u003cdate-time>"}],"isRequired":true,"uniqueKey":"items.[INDEX].updatedAt","typeLabel":"string | string\u003cdate-time>"},"item":{"oneOf":[{"type":"object","description":"Details of the item being listed","required":["urn","type","game","title","name","rarity","set","series","images","alternatives","metadata"],"properties":{"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.urn","typeLabel":"string"},"type":{"type":"string","enum":["card"],"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.type","typeLabel":"enum\u003cstring>"},"game":{"type":"string","enum":["Pokemon"],"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.game","typeLabel":"enum\u003cstring>"},"title":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.title","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.name","typeLabel":"string"},"rarity":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.rarity","typeLabel":"string"},"set":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.set.name","typeLabel":"string"},"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.set.urn","typeLabel":"string"},"counts":{"type":"object","properties":{"printed":{"type":"number","uniqueKey":"items.[INDEX].item.oneOf.0.set.counts.printed","typeLabel":"number"},"total":{"type":"number","uniqueKey":"items.[INDEX].item.oneOf.0.set.counts.total","typeLabel":"number"}},"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.set.counts","typeLabel":"object"},"references":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX].item.oneOf.0.set.references.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.set.references","typeLabel":"string[]"},"size":{"type":"number","uniqueKey":"items.[INDEX].item.oneOf.0.set.size","typeLabel":"number"},"symbol":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.set.symbol.url","typeLabel":"string"}},"required":["url"],"uniqueKey":"items.[INDEX].item.oneOf.0.set.symbol","typeLabel":"object"},"released":{"type":"string","uniqueKey":"items.[INDEX].item.oneOf.0.set.released","typeLabel":"string"}},"required":["name","urn","counts","references"],"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.set","typeLabel":"object"},"series":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.series.name","typeLabel":"string"},"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.series.urn","typeLabel":"string"}},"required":["name","urn"],"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.series","typeLabel":"object"},"images":{"type":"array","items":{"type":"object","properties":{"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.images.items.[INDEX].urn","typeLabel":"string"},"orientation":{"type":"string","enum":["portrait","landscape"],"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.images.items.[INDEX].orientation","typeLabel":"enum\u003cstring>"},"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.images.items.[INDEX].url","typeLabel":"string\u003curi>"},"illustrator":{"type":"string","uniqueKey":"items.[INDEX].item.oneOf.0.images.items.[INDEX].illustrator","typeLabel":"string"}},"required":["urn","orientation","url"],"uniqueKey":"items.[INDEX].item.oneOf.0.images.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.images","typeLabel":"object[]"},"alternatives":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX].item.oneOf.0.alternatives.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.alternatives","typeLabel":"string[]"},"metadata":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.metadata.items.[INDEX].name","typeLabel":"string"},"value":{"oneOf":[{"type":"string","uniqueKey":"items.[INDEX].item.oneOf.0.metadata.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX].item.oneOf.0.metadata.items.[INDEX].value.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"items.[INDEX].item.oneOf.0.metadata.items.[INDEX].value.oneOf.1","typeLabel":"string[]"},{"type":"number","uniqueKey":"items.[INDEX].item.oneOf.0.metadata.items.[INDEX].value.oneOf.2","typeLabel":"number"},{"type":"array","items":{"type":"number","uniqueKey":"items.[INDEX].item.oneOf.0.metadata.items.[INDEX].value.oneOf.3.items.[INDEX]","typeLabel":"number"},"uniqueKey":"items.[INDEX].item.oneOf.0.metadata.items.[INDEX].value.oneOf.3","typeLabel":"number[]"}],"uniqueKey":"items.[INDEX].item.oneOf.0.metadata.items.[INDEX].value","typeLabel":"string | string[] | number | number[]"},"detail":{"oneOf":[{},{"type":"array","items":{"oneOf":[{}],"uniqueKey":"items.[INDEX].item.oneOf.0.metadata.items.[INDEX].detail.oneOf.1.items.[INDEX]","typeLabel":"any"},"uniqueKey":"items.[INDEX].item.oneOf.0.metadata.items.[INDEX].detail.oneOf.1","typeLabel":"any[]"},{"type":"null","uniqueKey":"items.[INDEX].item.oneOf.0.metadata.items.[INDEX].detail.oneOf.2","typeLabel":"null"}],"uniqueKey":"items.[INDEX].item.oneOf.0.metadata.items.[INDEX].detail","typeLabel":"any[] | null"}},"required":["name"],"uniqueKey":"items.[INDEX].item.oneOf.0.metadata.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.metadata","typeLabel":"object[]"},"number":{"oneOf":[{"type":"string","uniqueKey":"items.[INDEX].item.oneOf.0.number.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"items.[INDEX].item.oneOf.0.number.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].item.oneOf.0.number","typeLabel":"string | null"},"description":{"type":"string","uniqueKey":"items.[INDEX].item.oneOf.0.description","typeLabel":"string"},"price":{"type":"integer","uniqueKey":"items.[INDEX].item.oneOf.0.price","typeLabel":"integer"},"available":{"type":"integer","default":0,"description":"Total available for this listing","uniqueKey":"items.[INDEX].item.oneOf.0.available","typeLabel":"integer"},"quantity":{"type":"integer","default":0,"description":"Total quantity available","uniqueKey":"items.[INDEX].item.oneOf.0.quantity","typeLabel":"integer"},"min":{"type":"object","properties":{"price":{"oneOf":[{"type":"integer","description":"Price of the cheapest listing in pence","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.min.price.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Price of the cheapest listing in pence","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.min.price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.min.price","typeLabel":"integer | null"}},"required":["price"],"uniqueKey":"items.[INDEX].item.oneOf.0.min","typeLabel":"object"},"max":{"type":"object","properties":{"price":{"oneOf":[{"type":"integer","description":"Price of the most expensive listing in pence","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.max.price.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Price of the most expensive listing in pence","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.max.price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0.max.price","typeLabel":"integer | null"}},"required":["price"],"uniqueKey":"items.[INDEX].item.oneOf.0.max","typeLabel":"object"}},"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.0","typeLabel":"object"},{"type":"object","description":"Details of the item being listed","required":["urn","type","game","title","name","classification","count","images","series","set","metadata"],"properties":{"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.urn","typeLabel":"string"},"type":{"type":"string","enum":["product"],"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.type","typeLabel":"enum\u003cstring>"},"game":{"type":"string","enum":["Pokemon"],"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.game","typeLabel":"enum\u003cstring>"},"title":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.title","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.name","typeLabel":"string"},"classification":{"type":"string","enum":["CARD"],"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.classification","typeLabel":"enum\u003cstring>"},"count":{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.count","typeLabel":"number"},"images":{"type":"array","items":{"type":"object","properties":{"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.images.items.[INDEX].urn","typeLabel":"string"},"orientation":{"type":"string","enum":["portrait","landscape"],"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.images.items.[INDEX].orientation","typeLabel":"enum\u003cstring>"},"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.images.items.[INDEX].url","typeLabel":"string\u003curi>"},"illustrator":{"type":"string","uniqueKey":"items.[INDEX].item.oneOf.1.images.items.[INDEX].illustrator","typeLabel":"string"}},"required":["urn","orientation","url"],"uniqueKey":"items.[INDEX].item.oneOf.1.images.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.images","typeLabel":"object[]"},"series":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.series.name","typeLabel":"string"},"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.series.urn","typeLabel":"string"}},"required":["name","urn"],"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.series","typeLabel":"object"},"set":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.set.name","typeLabel":"string"},"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.set.urn","typeLabel":"string"},"counts":{"type":"object","properties":{"printed":{"type":"number","uniqueKey":"items.[INDEX].item.oneOf.1.set.counts.printed","typeLabel":"number"},"total":{"type":"number","uniqueKey":"items.[INDEX].item.oneOf.1.set.counts.total","typeLabel":"number"}},"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.set.counts","typeLabel":"object"},"references":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX].item.oneOf.1.set.references.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.set.references","typeLabel":"string[]"},"size":{"type":"number","uniqueKey":"items.[INDEX].item.oneOf.1.set.size","typeLabel":"number"},"symbol":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.set.symbol.url","typeLabel":"string"}},"required":["url"],"uniqueKey":"items.[INDEX].item.oneOf.1.set.symbol","typeLabel":"object"},"released":{"type":"string","uniqueKey":"items.[INDEX].item.oneOf.1.set.released","typeLabel":"string"}},"required":["name","urn","counts","references"],"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.set","typeLabel":"object"},"metadata":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.metadata.items.[INDEX].name","typeLabel":"string"},"value":{"oneOf":[{"type":"string","uniqueKey":"items.[INDEX].item.oneOf.1.metadata.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX].item.oneOf.1.metadata.items.[INDEX].value.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"items.[INDEX].item.oneOf.1.metadata.items.[INDEX].value.oneOf.1","typeLabel":"string[]"},{"type":"number","uniqueKey":"items.[INDEX].item.oneOf.1.metadata.items.[INDEX].value.oneOf.2","typeLabel":"number"},{"type":"array","items":{"type":"number","uniqueKey":"items.[INDEX].item.oneOf.1.metadata.items.[INDEX].value.oneOf.3.items.[INDEX]","typeLabel":"number"},"uniqueKey":"items.[INDEX].item.oneOf.1.metadata.items.[INDEX].value.oneOf.3","typeLabel":"number[]"}],"uniqueKey":"items.[INDEX].item.oneOf.1.metadata.items.[INDEX].value","typeLabel":"string | string[] | number | number[]"},"detail":{"oneOf":[{},{"type":"array","items":{"oneOf":[{}],"uniqueKey":"items.[INDEX].item.oneOf.1.metadata.items.[INDEX].detail.oneOf.1.items.[INDEX]","typeLabel":"any"},"uniqueKey":"items.[INDEX].item.oneOf.1.metadata.items.[INDEX].detail.oneOf.1","typeLabel":"any[]"},{"type":"null","uniqueKey":"items.[INDEX].item.oneOf.1.metadata.items.[INDEX].detail.oneOf.2","typeLabel":"null"}],"uniqueKey":"items.[INDEX].item.oneOf.1.metadata.items.[INDEX].detail","typeLabel":"any[] | null"}},"required":["name"],"uniqueKey":"items.[INDEX].item.oneOf.1.metadata.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.metadata","typeLabel":"object[]"},"description":{"type":"string","uniqueKey":"items.[INDEX].item.oneOf.1.description","typeLabel":"string"},"price":{"type":"integer","uniqueKey":"items.[INDEX].item.oneOf.1.price","typeLabel":"integer"},"available":{"type":"integer","default":0,"description":"Total available for this listing","uniqueKey":"items.[INDEX].item.oneOf.1.available","typeLabel":"integer"},"quantity":{"type":"integer","default":0,"description":"Total quantity available","uniqueKey":"items.[INDEX].item.oneOf.1.quantity","typeLabel":"integer"},"min":{"type":"object","properties":{"price":{"oneOf":[{"type":"integer","description":"Price of the cheapest listing in pence","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.min.price.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Price of the cheapest listing in pence","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.min.price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.min.price","typeLabel":"integer | null"}},"required":["price"],"uniqueKey":"items.[INDEX].item.oneOf.1.min","typeLabel":"object"},"max":{"type":"object","properties":{"price":{"oneOf":[{"type":"integer","description":"Price of the most expensive listing in pence","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.max.price.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Price of the most expensive listing in pence","isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.max.price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1.max.price","typeLabel":"integer | null"}},"required":["price"],"uniqueKey":"items.[INDEX].item.oneOf.1.max","typeLabel":"object"}},"isRequired":true,"uniqueKey":"items.[INDEX].item.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"items.[INDEX].item","typeLabel":"object"},"seller":{"type":"object","description":"Seller of the listing","required":["id","username","reviews","rating","score","sales","purchases"],"properties":{"id":{"type":"string","description":"Unique identifier for the user","isRequired":true,"uniqueKey":"items.[INDEX].seller.id","typeLabel":"string"},"username":{"type":"string","description":"Public username of the user","isRequired":true,"uniqueKey":"items.[INDEX].seller.username","typeLabel":"string"},"reviews":{"type":"integer","description":"Total number of reviews the user has received","isRequired":true,"uniqueKey":"items.[INDEX].seller.reviews","typeLabel":"integer"},"rating":{"type":"number","description":"Confidence-based rating between 0 and 5","isRequired":true,"uniqueKey":"items.[INDEX].seller.rating","typeLabel":"number"},"score":{"type":"number","description":"Average rating between 0 and 5","isRequired":true,"uniqueKey":"items.[INDEX].seller.score","typeLabel":"number"},"sales":{"type":"integer","description":"Total number of sales the user has made","isRequired":true,"uniqueKey":"items.[INDEX].seller.sales","typeLabel":"integer"},"purchases":{"type":"integer","description":"Total number of purchases the user has made","isRequired":true,"uniqueKey":"items.[INDEX].seller.purchases","typeLabel":"integer"},"joined":{"type":"string","format":"date-time","description":"ISO timestamp when the user account was created","uniqueKey":"items.[INDEX].seller.joined","typeLabel":"string\u003cdate-time>"},"avatar":{"type":"string","format":"uri","description":"URL to the user's avatar image","uniqueKey":"items.[INDEX].seller.avatar","typeLabel":"string\u003curi>"},"cover":{"type":"string","format":"uri","description":"URL to the user's cover image","uniqueKey":"items.[INDEX].seller.cover","typeLabel":"string\u003curi>"},"profile":{"type":"string","description":"Information about the user","uniqueKey":"items.[INDEX].seller.profile","typeLabel":"string"}},"isRequired":true,"uniqueKey":"items.[INDEX].seller","typeLabel":"object"},"locked":{"type":"boolean","description":"True when the listing has active item holds","isRequired":true,"uniqueKey":"items.[INDEX].locked","typeLabel":"boolean"},"valid":{"type":"boolean","description":"True when the listing meets all requirements","isRequired":true,"uniqueKey":"items.[INDEX].valid","typeLabel":"boolean"},"hidden":{"type":"boolean","description":"True when the listing is hidden from buyers","isRequired":true,"uniqueKey":"items.[INDEX].hidden","typeLabel":"boolean"},"quantity":{"type":"integer","default":1,"description":"Total quantity for this listings","uniqueKey":"items.[INDEX].quantity","typeLabel":"integer"},"available":{"type":"integer","default":0,"description":"Total available for this listing","uniqueKey":"items.[INDEX].available","typeLabel":"integer"},"variants":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX].variants.items.[INDEX]","typeLabel":"string"},"default":[],"description":"Variants of the listed card","uniqueKey":"items.[INDEX].variants","typeLabel":"string[]"},"comment":{"oneOf":[{"type":"string","description":"Seller's comment about the listing","uniqueKey":"items.[INDEX].comment.oneOf.0","typeLabel":"string"},{"type":"null","description":"Seller's comment about the listing","uniqueKey":"items.[INDEX].comment.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].comment","typeLabel":"string | null"},"gradingProvider":{"oneOf":[{"type":"string","description":"Provider responsible for grading the card","uniqueKey":"items.[INDEX].gradingProvider.oneOf.0","typeLabel":"string"},{"type":"null","description":"Provider responsible for grading the card","uniqueKey":"items.[INDEX].gradingProvider.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].gradingProvider","typeLabel":"string | null"},"gradingScore":{"oneOf":[{"type":"string","description":"Score assigned to the card by the grading provider","uniqueKey":"items.[INDEX].gradingScore.oneOf.0","typeLabel":"string"},{"type":"null","description":"Score assigned to the card by the grading provider","uniqueKey":"items.[INDEX].gradingScore.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].gradingScore","typeLabel":"string | null"},"gradingNumber":{"oneOf":[{"type":"string","description":"Certificate or registration number issued by the grading provider","uniqueKey":"items.[INDEX].gradingNumber.oneOf.0","typeLabel":"string"},{"type":"null","description":"Certificate or registration number issued by the grading provider","uniqueKey":"items.[INDEX].gradingNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].gradingNumber","typeLabel":"string | null"},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Image identifier","isRequired":true,"uniqueKey":"items.[INDEX].attachments.items.[INDEX].id","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"Public URL for the attachment","isRequired":true,"uniqueKey":"items.[INDEX].attachments.items.[INDEX].url","typeLabel":"string\u003curi>"}},"required":["id","url"],"description":"Image attachment linked to a listing","uniqueKey":"items.[INDEX].attachments.items.[INDEX]","typeLabel":"object"},"default":[],"description":"Image attachments for the listing","uniqueKey":"items.[INDEX].attachments","typeLabel":"object[]"},"notes":{"oneOf":[{"type":"string","maxLength":255,"description":"Private notes for the seller such as SKUs or storage locations","uniqueKey":"items.[INDEX].notes.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"description":"Private notes for the seller such as SKUs or storage locations","uniqueKey":"items.[INDEX].notes.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].notes","typeLabel":"string | null"},"reference":{"oneOf":[{"type":"string","maxLength":255,"description":"Third-party integration reference for this listing","uniqueKey":"items.[INDEX].reference.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"description":"Third-party integration reference for this listing","uniqueKey":"items.[INDEX].reference.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].reference","typeLabel":"string | null"}},"required":["id","sellerId","condition","price","language","createdAt","updatedAt","item","seller","locked","valid","hidden"],"uniqueKey":"items.[INDEX]","typeLabel":"object"},"title":"Seller Listings","description":"Listings for a specific item owned by the authenticated seller","uniqueKey":"","typeLabel":"Seller Listings · object[]"},"examples":{"Example":{"title":"Example","value":[{"id":"\u003cstring>","sellerId":"\u003cstring>","condition":"\u003cstring>","price":123,"language":"\u003cstring>","createdAt":"\u003cstring>","updatedAt":"\u003cstring>","item":{"urn":"\u003cstring>","type":"card","game":"Pokemon","title":"\u003cstring>","name":"\u003cstring>","rarity":"\u003cstring>","set":{"name":"\u003cstring>","urn":"\u003cstring>","counts":{"printed":123,"total":123},"references":["\u003cstring>"],"size":123,"symbol":{"url":"\u003cstring>"},"released":"\u003cstring>"},"series":{"name":"\u003cstring>","urn":"\u003cstring>"},"images":[{"urn":"\u003cstring>","orientation":"portrait","url":"\u003cstring>","illustrator":"\u003cstring>"}],"alternatives":["\u003cstring>"],"metadata":[{"name":"\u003cstring>","value":"\u003cstring>","detail":["\u003cunknown>"]}],"number":"\u003cstring>","description":"\u003cstring>","price":123,"available":0,"quantity":0,"min":{"price":123},"max":{"price":123}},"seller":{"id":"\u003cstring>","username":"\u003cstring>","reviews":123,"rating":123,"score":123,"sales":123,"purchases":123,"joined":"2023-11-07T05:31:56Z","avatar":"\u003cstring>","cover":"\u003cstring>","profile":"\u003cstring>"},"locked":true,"valid":true,"hidden":true,"quantity":1,"available":0,"variants":[],"comment":"\u003cstring>","gradingProvider":"\u003cstring>","gradingScore":"\u003cstring>","gradingNumber":"\u003cstring>","attachments":[],"notes":"\u003cstring>","reference":"\u003cstring>"}]}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e0c34db8-7365-4aa6-b3dc-13ef45ac48d5":{"Bearer":{"type":"http","scheme":"bearer","scopes":[]}}},"servers":{"a1faa4d7-f526-41b5-8c48-d2be7d297f34":{"url":"https://api.managem.co.uk","description":"Production API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"Bearer","name":"Authorization"}],"title":"Bearer"}]},"originalFileLocation":"https://api.managem.co.uk/doc"},"subdomain":"managem","siteName":"docs","title":"List listings by item - docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-29T05:02:00.276Z","originalFileLocation":"api-reference/seller-listings/list-listings-by-item.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"List the authenticated seller\u0026#x27;s active listings for a specific item URN. This endpoint is useful for item-centric listing management screens where a seller wants all of their offers for one product. Query and ownership rules: - Requires urn query parameter. - Returns only listings owned by the authenticated seller. - Returns only listings with quantity \u0026gt; 0 (active listings). Data sources: - Listing rows are loaded from the primary database. - Item metadata is enriched from the catalog search index. - Listing lock state is derived from listing hold records. - Attachment URLs are attached to each listing in the response. Response notes: - If no active listings exist for the provided URN, the API returns an empty array. - The available quantity in this response mirrors listing quantity.\">\u003cmeta data-mint-head name=\"application-name\" content=\"docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/managem/tj0HUBDvoCmgK6BV/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/managem/tj0HUBDvoCmgK6BV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/managem/tj0HUBDvoCmgK6BV/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/managem/tj0HUBDvoCmgK6BV/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/managem/tj0HUBDvoCmgK6BV/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/managem/tj0HUBDvoCmgK6BV/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/managem/tj0HUBDvoCmgK6BV/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/managem/tj0HUBDvoCmgK6BV/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/managem/tj0HUBDvoCmgK6BV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List listings by item - docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"List the authenticated seller\u0026#x27;s active listings for a specific item URN. This endpoint is useful for item-centric listing management screens where a seller wants all of their offers for one product. Query and ownership rules: - Requires urn query parameter. - Returns only listings owned by the authenticated seller. - Returns only listings with quantity \u0026gt; 0 (active listings). Data sources: - Listing rows are loaded from the primary database. - Item metadata is enriched from the catalog search index. - Listing lock state is derived from listing hold records. - Attachment URLs are attached to each listing in the response. Response notes: - If no active listings exist for the provided URN, the API returns an empty array. - The available quantity in this response mirrors listing quantity.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.managem.co.uk/api-reference/seller-listings/list-listings-by-item\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://managem.mintlify.app/_mintlify/api/og/v2?division=Search\u0026amp;title=List+listings+by+item\u0026amp;description=%0AList+the+authenticated+seller%27s+active+listings+for+a+specific+item+URN.%0A%0AThis+endpoint+is+useful+for+item-centric+listing+management+screens+where+a+seller+wa\u0026amp;theme=be07e209d93d2fc80a8b1eae\u0026amp;signature=eb90b552e6b1530adac146cabc65fb8bdc174d41f004f0128b9bae6615f302c9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List listings by item - docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List the authenticated seller\u0026#x27;s active listings for a specific item URN. This endpoint is useful for item-centric listing management screens where a seller wants all of their offers for one product. Query and ownership rules: - Requires urn query parameter. - Returns only listings owned by the authenticated seller. - Returns only listings with quantity \u0026gt; 0 (active listings). Data sources: - Listing rows are loaded from the primary database. - Item metadata is enriched from the catalog search index. - Listing lock state is derived from listing hold records. - Attachment URLs are attached to each listing in the response. Response notes: - If no active listings exist for the provided URN, the API returns an empty array. - The available quantity in this response mirrors listing quantity.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://managem.mintlify.app/_mintlify/api/og/v2?division=Search\u0026amp;title=List+listings+by+item\u0026amp;description=%0AList+the+authenticated+seller%27s+active+listings+for+a+specific+item+URN.%0A%0AThis+endpoint+is+useful+for+item-centric+listing+management+screens+where+a+seller+wa\u0026amp;theme=be07e209d93d2fc80a8b1eae\u0026amp;signature=eb90b552e6b1530adac146cabc65fb8bdc174d41f004f0128b9bae6615f302c9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/managem/tj0HUBDvoCmgK6BV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#927dff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.managem.co.uk/api-reference/seller-listings/list-listings-by-item\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/seller-listings/list-listings-by-item.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.managem.co.uk/#organization\",\"name\":\"docs\",\"url\":\"https://docs.managem.co.uk\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/managem/JwthiBp-Ca5zDncq/logo/logo.svg?fit=max\u0026auto=format\u0026n=JwthiBp-Ca5zDncq\u0026q=85\u0026s=781554ca2edef422e6d5522cec6abe6f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.managem.co.uk#website\",\"name\":\"docs\",\"url\":\"https://docs.managem.co.uk\",\"publisher\":{\"@id\":\"https://docs.managem.co.uk/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.managem.co.uk/api-reference/seller-listings/list-listings-by-item#webpage\",\"url\":\"https://docs.managem.co.uk/api-reference/seller-listings/list-listings-by-item\",\"name\":\"List listings by item\",\"description\":\"List the authenticated seller's active listings for a specific item URN. This endpoint is useful for item-centric listing management screens where a seller wants all of their offers for one product. Query and ownership rules: - Requires urn query parameter. - Returns only listings owned by the authenticated seller. - Returns only listings with quantity > 0 (active listings). Data sources: - Listing rows are loaded from the primary database. - Item metadata is enriched from the catalog search index. - Listing lock state is derived from listing hold records. - Attachment URLs are attached to each listing in the response. Response notes: - If no active listings exist for the provided URN, the API returns an empty array. - The available quantity in this response mirrors listing quantity.\",\"dateModified\":\"2026-03-29T05:02:00.276Z\",\"isPartOf\":{\"@id\":\"https://docs.managem.co.uk#website\"},\"breadcrumb\":{\"@id\":\"https://docs.managem.co.uk/api-reference/seller-listings/list-listings-by-item#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.managem.co.uk/api-reference/seller-listings/list-listings-by-item#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Listings\",\"item\":\"https://docs.managem.co.uk/api-reference/seller-listings/create-listing\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Search\",\"item\":\"https://docs.managem.co.uk/api-reference/seller-listings/search-your-listings\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List listings by item\",\"item\":\"https://docs.managem.co.uk/api-reference/seller-listings/list-listings-by-item\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.managem.co.uk/api-reference/seller-listings/list-listings-by-item#apireference\",\"headline\":\"List listings by item\",\"name\":\"List listings by item\",\"description\":\"List the authenticated seller's active listings for a specific item URN. This endpoint is useful for item-centric listing management screens where a seller wants all of their offers for one product. Query and ownership rules: - Requires urn query parameter. - Returns only listings owned by the authenticated seller. - Returns only listings with quantity > 0 (active listings). Data sources: - Listing rows are loaded from the primary database. - Item metadata is enriched from the catalog search index. - Listing lock state is derived from listing hold records. - Attachment URLs are attached to each listing in the response. Response notes: - If no active listings exist for the provided URN, the API returns an empty array. - The available quantity in this response mirrors listing quantity.\",\"url\":\"https://docs.managem.co.uk/api-reference/seller-listings/list-listings-by-item\",\"mainEntityOfPage\":{\"@id\":\"https://docs.managem.co.uk/api-reference/seller-listings/list-listings-by-item#webpage\"},\"dateModified\":\"2026-03-29T05:02:00.276Z\",\"publisher\":{\"@id\":\"https://docs.managem.co.uk/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.managem.co.uk#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"docs","nav":{"global":{"anchors":[{"anchor":"Documentation","icon":"book","href":"https://docs.managem.co.uk"},{"anchor":"Connect AI","icon":"bot","href":"/mcp"}]},"tabs":[{"tab":"Marketplace","icon":"store","pages":[{"title":"Marketplace","href":"/marketplace/search-and-data"}]},{"tab":"Sellers","groups":[{"group":"Selling","icon":"store","pages":[{"title":"Overview","href":"/sellers"},{"title":"Getting started","href":"/sellers/getting-started"},{"title":"Grading your cards","href":"/sellers/grading-your-cards"},{"title":null,"href":"/sellers/packing-your-order"}]},{"group":"Listings","icon":"list","pages":[{"group":"Management","expanded":false,"pages":[{"title":"Create listing","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /seller/listings","href":"/api-reference/seller-listings/create-listing"},{"title":"Bulk create listings","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /seller/listings/bulk","href":"/api-reference/seller-listings/bulk-create-listings"},{"title":"Get listing","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/listings/{id}","href":"/api-reference/seller-listings/get-listing"},{"title":"Update listing","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc put /seller/listings/{id}","href":"/api-reference/seller-listings/update-listing"},{"title":"Delete listing","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc delete /seller/listings/{id}","href":"/api-reference/seller-listings/delete-listing"}]},{"group":"Search","expanded":false,"pages":[{"title":"Search your listings","description":"\nSearch the authenticated seller's listings using full-text query and facets.\n\nThis endpoint is optimized for seller backoffice listing management views.\n\nSearch behavior:\n- Executes against the listings search index with seller-scoped filtering.\n- The API enforces seller ownership by injecting the authenticated seller facet server-side.\n- Additional user-provided facets are merged with seller scoping.\n\nResponse enrichment:\n- Returns indexed listing hits plus seller-specific metadata from the primary database.\n- Adds:\n - `valid` and `hidden` flags from listing records.\n - `locked` status when active listing holds exist.\n - `attachments` array with public URLs.\n\nAuthentication:\n- Caller must map to an existing seller account.\n\nUse this endpoint when you need filterable, paginated, relevance-aware listing search for the current seller.\n","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /seller/listings/search","href":"/api-reference/seller-listings/search-your-listings"},{"title":"List listings by item","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/listings/items","href":"/api-reference/seller-listings/list-listings-by-item"}]},{"group":"Image attachments","expanded":false,"pages":[{"title":"Create attachment","description":"\nCreate a draft attachment upload for a listing and return a direct upload URL.\n\nThis is step 1 of the listing attachment workflow.\n\nWorkflow:\n1. Call this endpoint to obtain `id` and `uploadURL`.\n2. Upload the image bytes directly to the returned URL.\n3. Call finalize attachment to validate and persist the attachment on the listing.\n\nRules:\n- Listing must belong to the authenticated seller.\n- Listing must be active (`quantity > 0`).\n- The returned image identifier is namespaced to the listing and seller context.\n\nResponse:\n- Returns an `ImageUpload` payload with the image identifier and direct upload URL.\n","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /seller/listings/{id}/attachments","href":"/api-reference/seller-listings/create-attachment"},{"title":"Finalize attachment","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc patch /seller/listings/{id}/attachments","href":"/api-reference/seller-listings/finalize-attachment"},{"title":"Delete attachment","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc delete /seller/listings/{id}/attachments","href":"/api-reference/seller-listings/delete-attachment"}]},{"title":"Suggest listing prices","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /seller/listings/suggest","href":"/api-reference/seller-listings/suggest-listing-prices"}]},{"group":"Account","icon":"user","pages":[{"title":"Create seller account","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /seller","href":"/api-reference/seller-account/create-seller-account"},{"title":"Get seller account","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller","href":"/api-reference/seller-account/get-seller-account"},{"title":"Get seller status","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/status","href":"/api-reference/seller-account/get-seller-status"},{"title":"Update vacation mode","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc patch /seller/vacation","href":"/api-reference/seller-account/update-vacation-mode"},{"title":"Get dashboard link","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/dashboard","href":"/api-reference/seller-account/get-dashboard-link"}]},{"group":"Finance","icon":"notebook","expanded":false,"pages":[{"title":"Retrieve balance","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/balance","href":"/api-reference/seller-finance/retrieve-balance"},{"title":"Create payout","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /seller/payouts/withdraw","href":"/api-reference/seller-finance/create-payout"},{"title":"List payouts","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/payouts","href":"/api-reference/seller-finance/list-payouts"},{"title":"List transfers","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/transfers","href":"/api-reference/seller-finance/list-transfers"}]},{"group":"Delivery Configuration","icon":"truck","expanded":false,"pages":[{"title":"Get configuration","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/delivery-options","href":"/api-reference/seller-delivery-options/get-configuration"},{"title":"Update configuration","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc put /seller/delivery-options","href":"/api-reference/seller-delivery-options/update-configuration"}]},{"group":"Orders","icon":"shopping-cart","expanded":false,"pages":[{"group":"Management","expanded":false,"pages":[{"title":"List orders","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/orders","href":"/api-reference/seller-orders/list-orders"},{"title":"Get order","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/orders/{id}","href":"/api-reference/seller-orders/get-order"},{"title":"Update order","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /seller/orders/{id}","href":"/api-reference/seller-orders/update-order"},{"title":"Get order history","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/orders/{id}/history","href":"/api-reference/seller-orders/get-order-history"},{"title":"Cancel order","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /seller/orders/{id}/cancel","href":"/api-reference/seller-orders/cancel-order"}]},{"group":"Carriers","expanded":false,"pages":[{"title":"List carrier","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/orders/carriers","href":"/api-reference/seller-orders/list-carrier"}]},{"group":"Packing slip","expanded":false,"pages":[{"title":"Create packing slip","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/orders/{id}/packing-slip","href":"/api-reference/seller-orders/create-packing-slip"}]},{"group":"Shipment attachments","expanded":false,"pages":[{"title":"Create attachment","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /seller/orders/{id}/shipments/{shipmentId}/attachments","href":"/api-reference/seller-orders/create-attachment"},{"title":"Finalize attachment","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc patch /seller/orders/{id}/shipments/{shipmentId}/attachments","href":"/api-reference/seller-orders/finalize-attachment"}]}]},{"group":"Cases","icon":"heart-crack","expanded":false,"pages":[{"title":"Overview","href":"/sellers/cases/index"},{"title":"List case","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/cases","href":"/api-reference/seller-cases/list-case"},{"title":"Get case","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/cases/{id}","href":"/api-reference/seller-cases/get-case"},{"title":"Update case","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc put /seller/cases/{id}","href":"/api-reference/seller-cases/update-case"},{"group":"Case attachments","pages":[{"title":"Create case attachment","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /seller/cases/{id}/attachments","href":"/api-reference/seller-cases/create-case-attachment"},{"title":"Finalize attachment","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc patch /seller/cases/{id}/attachments","href":"/api-reference/seller-cases/finalize-attachment"}]}]},{"group":"Imports","icon":"cloud-upload","expanded":false,"pages":[{"title":"Overview","href":"/sellers/imports/index"},{"title":"Building a CSV","href":"/sellers/imports/building-a-csv"},{"title":"Creating an Import","href":"/sellers/imports/creating-an-import"},{"title":"Handling Import Errors","href":"/sellers/imports/handling-errors"},{"title":"List imports","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/imports","href":"/api-reference/seller-imports/list-imports"},{"title":"Create an import","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /seller/imports","href":"/api-reference/seller-imports/create-an-import"},{"title":"Retrieve an import","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/imports/{id}","href":"/api-reference/seller-imports/retrieve-an-import"},{"title":"Stop/Start an import","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc patch /seller/imports/{id}/status/{mode}","href":"/api-reference/seller-imports/stopstart-an-import"}]},{"group":"Webhooks","icon":"plug","expanded":false,"pages":[{"title":"Overview","href":"/sellers/webhooks/index"},{"group":"Management","pages":[{"title":"Get delivery metrics","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/webhooks/metrics","href":"/api-reference/seller-webhooks/get-delivery-metrics"},{"title":"List webhooks","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/webhooks","href":"/api-reference/seller-webhooks/list-webhooks"},{"title":"Create webhook","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /seller/webhooks","href":"/api-reference/seller-webhooks/create-webhook"},{"title":"Retrieve a webhook","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/webhooks/{webhookId}","href":"/api-reference/seller-webhooks/retrieve-a-webhook"},{"title":"Update a webhook","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc patch /seller/webhooks/{webhookId}","href":"/api-reference/seller-webhooks/update-a-webhook"},{"title":"Delete webhook","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc delete /seller/webhooks/{webhookId}","href":"/api-reference/seller-webhooks/delete-webhook"},{"title":"Replace a subscription","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc put /seller/webhooks/{webhookId}/subscriptions","href":"/api-reference/seller-webhooks/replace-a-subscription"}]},{"group":"Testing","pages":[{"title":"Test webhook delivery","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/webhooks/{webhookId}/test","href":"/api-reference/seller-webhooks/test-webhook-delivery"}]},{"group":"Error handling","pages":[{"title":"List delivery failures","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/webhooks/{webhookId}/failures","href":"/api-reference/seller-webhooks/list-delivery-failures"},{"title":"Retrieve webhook failure","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/webhooks/{webhookId}/failures/{failureId}","href":"/api-reference/seller-webhooks/retrieve-webhook-failure"},{"title":"Download failure HAR","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/webhooks/{webhookId}/failures/{failureId}/download","href":"/api-reference/seller-webhooks/download-failure-har"}]}]},{"group":"Stats","icon":"chart-bar","expanded":false,"pages":[{"title":"Get seller stat","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /seller/stats","href":"/api-reference/seller-stats/get-seller-stat"}]}]},{"tab":"Buyers","pages":[{"title":"Buyers","href":"/api-reference/basket/get-basket-items"}]}]},"title":"List listings by item - docs","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","Page-kQh739Uz.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js","Markdown-BuPH8yuW.js","clsx-CCOYKgaU.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BnkC_6oA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BM4S31-f.js"]}