{"uid":"cap_EYAYH9-9xxNECj_5o7LT7","slug":"pypi-yanked-status-check-1d49b400","name":"PyPI Yanked Status Check","description":"Was a PyPI release yanked? Exact version check with the maintainer's reason, upload date and file count.","url":"https://package-health.x402tookit.com/pypi-yanked?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["name","version"],"properties":{"name":{"type":"string","description":"PyPI project name"},"version":{"type":"string","description":"Exact version, e.g. 2.19.0"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"name":{"type":["null","string"]},"files":{"type":["null","number"]},"source":{"type":["null","string"]},"yanked":{"type":["boolean","null"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"version":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"uploaded":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"yankedReason":{},"requiresPython":{"type":["null","string"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ebja6QLmOnPz5q-dw-bRb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a specific PyPI package version has been yanked, returning the maintainer's reason, upload date, and file count.","exampleAgentPrompt":"Check if requests version 2.19.0 on PyPI has been yanked — I need to know if it's safe to use, why it was yanked if so, when it was uploaded, and how many files are in that release.","exampleUseCases":[{"title":"Auditing pinned CI dependencies","prompt":"Our CI pipeline pins requests==2.19.0 — can you check if that exact version has been yanked on PyPI and tell me the reason if so?"},{"title":"Investigating a failed pip install","prompt":"pip is warning me that urllib3 1.26.4 may have been yanked — can you look it up and tell me the maintainer's reason and when it was originally uploaded?"},{"title":"Supply chain safety check before deploy","prompt":"Before we deploy, verify whether Django 3.2.14 has been yanked from PyPI and give me the verdict summary and file count for that release."}],"resultDescription":"Returns a structured object with: yanked (boolean), yankedReason (the maintainer's stated reason), uploaded (ISO date of the release), files (count of distribution files), requiresPython (version constraint), verdict (human-readable summary), summary, sourceUrl, and degraded/notChecked flags if the check was partial.","failureModes":["Package name or version not found on PyPI — returns null fields or an appropriate error","Yanked reason not provided by maintainer — yankedReason field may be null even when yanked is true","PyPI API unavailable — degraded flag set to true with partial data","Invalid version string format — query returns no match","Rate limiting or upstream timeout from PyPI"],"whenToPreferThis":"Use this endpoint when you need to check a single, exact PyPI package version for yanked status — particularly in CI/CD pipelines, dependency audits, or supply chain security workflows. Prefer this over generic package health endpoints when the yanked/yank-reason signal is the primary concern, rather than license, provenance, or adoption metrics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:20:21.659Z","isFirstParty":false,"canonicalSlug":"pypi-yanked-status-check-1d49b400"}