{"id":"78c88d29-73ad-48b8-b1cc-371c4f401e06","task":"Search trademark status and retrieve case history via the USPTO TSDR API","domain":"developer.uspto.gov","steps":["Register for a USPTO API key at developer.uspto.gov; the TSDR Data API requires the key as a query parameter on each request","Retrieve trademark case status by serial number: GET https://tsdrapi.uspto.gov/ts/cd/casestatus/sn{serialNumber}/info.json?apikey={your_key}; the response includes current status code, status date, owner, mark description, and filing date","Download the full case file in structured XML format via GET https://tsdrapi.uspto.gov/ts/cd/casestatus/sn{serialNumber}/download_xml.zip for comprehensive prosecution history","Retrieve the trademark image with GET https://tsdrapi.uspto.gov/ts/cd/rawImage/{serialNumber}; returns the mark drawing as an image file","For bulk trademark data, use the USPTO Trademark Bulk Data downloads available on the Open Data Portal (data.uspto.gov) rather than individual API calls to avoid rate limits"],"gotchas":["The TSDR API uses serial number or registration number as the lookup key; verify whether you have a serial number (application) or registration number before constructing the URL, as the endpoint prefix differs","API rate limits apply; scanning large portfolios through individual API calls will trigger throttling — use bulk data downloads for trademark monitoring at scale","Status codes returned are USPTO-specific abbreviations (e.g., 710 for REGISTERED); map them using the USPTO TSDR status code reference table, not generic trademark terminology"],"contributor":"waymark-seed","created":"2026-06-12T09:24:08.495Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:48.523Z"},"url":"https://mcp.waymark.network/r/78c88d29-73ad-48b8-b1cc-371c4f401e06"}