{"openapi":"3.1.0","info":{"title":"Pocket Deal Radar Content API","version":"1.5","description":"Open access to worldwide Pokémon market rules, source-controlled content and stateless fail-safe purchase tools. No endpoint places an order, stores a user profile or turns self-reported evidence into BUY_NOW."},"servers":[{"url":"https://pocketdealradar.com"}],"paths":{"/api/v1/site":{"get":{"operationId":"getSiteManifest","summary":"Lees de identiteit en discovery-eindpunten van Pocket Deal Radar.","responses":{"200":{"description":"Site-manifest"}}}},"/api/v1/articles":{"get":{"operationId":"listArticles","summary":"Geef alle gepubliceerde artikelen met samenvatting, feiten, bronnen en wijzigingsdatum.","responses":{"200":{"description":"Artikelcollectie"}}}},"/api/v1/deals":{"get":{"operationId":"listDutchDealSnapshots","summary":"Geef actuele Nederlandse productcontroles, landed cost, bewijschecks en het dagsbesluit.","responses":{"200":{"description":"Deal-snapshotcollectie; geen koopclaim zonder volledig geslaagde verificatie"}}}},"/api/v1/deals/{slug}":{"get":{"operationId":"getDutchDealSnapshot","summary":"Geef één canonieke productcontrole met bron, controlemoment en mislukte checks.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Productcontrole"},"404":{"description":"Niet gevonden"}}}},"/api/v1/recommendations":{"post":{"operationId":"recommendPokemonPurchases","summary":"Rangschik actuele Nederlandse productcontroles op budget, taal, doel en productformaat zonder de veiligheidscontrole te omzeilen.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["budget_eur","purpose","languages"],"properties":{"budget_eur":{"type":"number","minimum":5,"maximum":2000},"purpose":{"type":"string","enum":["samen_openen","cadeau","uitdelen","gesloten_bewaren"]},"product_scale":{"type":"string","enum":["alles","compact","box"],"default":"alles"},"languages":{"type":"array","minItems":1,"maxItems":2,"items":{"type":"string","enum":["English","Japanese"]}}}}}}},"responses":{"200":{"description":"Fail-safe profielmatches; safe_match_count is alleen positief bij volledige verificatie"},"400":{"description":"Ongeldig profiel"}}}},"/api/v1/purchase-check":{"get":{"operationId":"getPokemonPurchaseCheckCapabilities","summary":"Lees de mogelijkheden en veiligheidsgrenzen van de stateless Pokémon Koopcheck.","responses":{"200":{"description":"Koopcheck-capabilities en fail-safe"}}},"post":{"operationId":"checkPokemonPurchaseIntake","summary":"Bereken all-in kosten en controleer of een listingdossier klaar is voor onafhankelijk marktonderzoek.","description":"Deze operatie haalt geen URL op, verwerkt geen afbeeldingen en kan nooit BUY_NOW produceren. Zelf ingevulde bewijsvelden worden uitsluitend als intake gebruikt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["product_kind","source_type","listing_url","product_identity","product_language","item_price_eur"],"properties":{"product_kind":{"type":"string","enum":["sealed_product","raw_card","slab"]},"source_type":{"type":"string","enum":["webshop","marketplace","cardmarket","ebay","other"]},"listing_url":{"type":"string","format":"uri","pattern":"^https://"},"product_identity":{"type":"string","maxLength":240,"description":"Exacte naam, setcode, productvorm of kaartnummer en variant."},"product_language":{"type":"string","enum":["English","Japanese","unknown"]},"seller_name":{"type":"string","maxLength":160,"default":""},"item_price_eur":{"type":"number","exclusiveMinimum":0,"maximum":100000},"shipping_eur":{"type":"number","minimum":0,"default":0},"platform_fees_eur":{"type":"number","minimum":0,"default":0},"import_costs_eur":{"type":"number","minimum":0,"default":0},"shipping_cost_confirmed":{"type":"boolean","default":false},"exact_contents_confirmed":{"type":"boolean","default":false},"seal_or_condition_confirmed":{"type":"boolean","default":false},"stock_confirmed":{"type":"boolean","default":false},"independent_reputation_confirmed":{"type":"boolean","default":false},"buyer_protection_confirmed":{"type":"boolean","default":false},"pack_count":{"type":"integer","minimum":1,"maximum":1000},"cards_per_pack":{"type":"integer","minimum":1,"maximum":100}}}}}},"responses":{"200":{"description":"READY_FOR_RESEARCH of NEEDS_EVIDENCE; commercial_verdict blijft UNAVAILABLE"},"400":{"description":"Ongeldige of niet-ondersteunde invoer"}}}},"/api/v1/merchant-feed-spec":{"get":{"operationId":"getMerchantFeedSpecification","summary":"Geef de minimale velden en rangschikkingsfirewall voor toekomstige betrouwbare winkel- en productfeeds.","responses":{"200":{"description":"Versiebeheerde Pokémon-productfeedspecificatie"}}}},"/api/v1/wholesale-margin":{"get":{"operationId":"getWholesaleMarginCapabilities","summary":"Lees de veiligheidsgrenzen en ondersteunde talen van het stateless Wholesale Profit Lab.","responses":{"200":{"description":"Wholesale-kostprijsmodel capabilities"}}},"post":{"operationId":"evaluateWholesaleMargin","summary":"Bereken bijdrage, doelwinkelprijs, kapitaalbeslag en testorderstatus voor één officiële Pokémon-SKU.","description":"De invoer wordt niet bewaard. De uitkomst is alleen een kostprijsmodel en bewijst geen vraag, authenticiteit, marktprijs of toekomstige winst.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["product_name","sku","product_language","units","purchase_price_ex_vat_eur","expected_retail_price_including_vat_eur"],"properties":{"product_name":{"type":"string","minLength":1,"maxLength":240},"sku":{"type":"string","minLength":1,"maxLength":120},"product_language":{"type":"string","enum":["English","Japanese"]},"units":{"type":"integer","minimum":1,"maximum":100000},"purchase_price_ex_vat_eur":{"type":"number","exclusiveMinimum":0},"inbound_shipping_ex_vat_eur":{"type":"number","minimum":0,"default":0},"expected_retail_price_including_vat_eur":{"type":"number","exclusiveMinimum":0},"customer_shipping_charge_including_vat_eur":{"type":"number","minimum":0,"default":0},"vat_rate_percent":{"type":"number","minimum":0,"maximum":30,"default":21},"variable_platform_fee_percent":{"type":"number","minimum":0,"maximum":40,"default":2.5},"fixed_payment_fee_eur":{"type":"number","minimum":0,"default":0.35},"outbound_shipping_eur":{"type":"number","minimum":0,"default":6.45},"packaging_eur":{"type":"number","minimum":0,"default":1.25},"return_damage_reserve_percent":{"type":"number","minimum":0,"maximum":30,"default":2},"expected_sell_through_percent":{"type":"number","minimum":0,"maximum":100,"default":70},"target_contribution_eur":{"type":"number","minimum":0,"default":8},"target_contribution_margin_percent":{"type":"number","minimum":0,"maximum":80,"default":12},"official_product_confirmed":{"type":"boolean","default":false},"supplier_invoice_confirmed":{"type":"boolean","default":false},"online_resale_allowed":{"type":"boolean","default":false},"market_price_verified":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"Kostprijs- en testorderanalyse met bewijschecks"},"400":{"description":"Ongeldige invoer"}}}},"/api/v1/commerce-readiness":{"get":{"operationId":"getCommerceReadiness","summary":"Lees de actuele activatiestatus en rangschikkingsfirewall voor eigen voorraad, affiliate, Pro en retailerdata.","responses":{"200":{"description":"Commerce-readiness manifest"}}}},"/api/v1/releases":{"get":{"operationId":"listPokemonReleases","summary":"Geef de officiële release-radar met bron, inhoud, risico en maximale koopprijs.","responses":{"200":{"description":"Releasecollectie"}}}},"/api/v1/releases/{slug}":{"get":{"operationId":"getPokemonRelease","summary":"Geef één canonieke releasepagina op basis van een stabiele slug.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Release"},"404":{"description":"Niet gevonden"}}}},"/api/v1/articles/{slug}":{"get":{"operationId":"getArticle","summary":"Geef één canoniek artikel op basis van de stabiele slug.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Artikel"},"404":{"description":"Artikel niet gevonden"}}}},"/api/v1/markets":{"get":{"operationId":"listMarketCapabilities","summary":"List supported buyer and seller markets, currencies and landed-cost rules.","responses":{"200":{"description":"Market capability collection"}}}},"/api/v1/rom-hacks":{"get":{"operationId":"listVerifiedRomHacks","summary":"List source-controlled legal Pokémon ROM-hack profiles.","responses":{"200":{"description":"Verified ROM-hack collection"}}}},"/api/v1/rom-hacks/{slug}":{"get":{"operationId":"getVerifiedRomHack","summary":"Get one canonical ROM-hack profile by stable slug.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Verified ROM-hack profile"},"404":{"description":"ROM-hack profile not found"}}}},"/api/v1/content-health":{"get":{"operationId":"getContentHealth","summary":"Geef de actuele versheids-, bron- en publicatiestatus van bewaakte pagina's.","responses":{"200":{"description":"Contentgezondheid en veilige onderhoudsactie"}}}}},"externalDocs":{"description":"Pocket Deal Radar interactive developer documentation","url":"https://pocketdealradar.com/developers"},"x-editorial-policy":"https://pocketdealradar.com/werkwijze"}