{"openapi":"3.1.0","info":{"title":"CopyMark Public Trademark API","version":"1.0.0","description":"Unauthenticated individual USPTO trademark lookups. Data is derived from USPTO public records; CopyMark adds plain-English interpretation where available. The USPTO remains the official source.","contact":{"name":"CopyMark Law Group","url":"https://getcopymark.com","email":"info@copymarklaw.com"}},"servers":[{"url":"https://getcopymark.com"}],"paths":{"/api/trademarks/{serialNumber}":{"get":{"operationId":"getTrademarkBySerial","summary":"Look up a USPTO trademark by serial number","description":"Returns sanitized public trademark data for an 8-digit USPTO serial number. No authentication required.","parameters":[{"name":"serialNumber","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{8}$","example":"87654321"},"description":"8-digit USPTO serial number"}],"responses":{"200":{"description":"Trademark found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTrademark"}}}},"400":{"description":"Invalid serial number","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Trademark not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}},"PublicTrademark":{"type":"object","required":["serialNumber","markName","status","dates","owners","goodsAndServices","events","pageUrl","tsdrUrl"],"properties":{"serialNumber":{"type":"string","example":"87654321"},"markName":{"type":"string"},"registrationNumber":{"type":["string","null"]},"status":{"type":"object","properties":{"code":{"type":["integer","null"]},"date":{"type":["string","null"]},"dateIso":{"type":["string","null"],"format":"date"},"plainEnglish":{"type":["string","null"]},"cataloguePath":{"type":["string","null"],"format":"uri"}}},"dates":{"type":"object","properties":{"filing":{"type":["string","null"]},"filingIso":{"type":["string","null"],"format":"date"},"registration":{"type":["string","null"]}}},"examinerName":{"type":["string","null"]},"lawOffice":{"type":["string","null"]},"whatThisMeans":{"type":"string"},"deadlineLabel":{"type":["string","null"]},"shortSummary":{"type":["string","null"]},"owners":{"type":"array","items":{"type":"object"}},"goodsAndServices":{"type":"array","items":{"type":"object"}},"events":{"type":"array","items":{"type":"object"}},"issues":{"type":"array","items":{"type":"object"}},"documentUrls":{"type":"array","items":{"type":"string","format":"uri"}},"drawingUrl":{"type":"string","format":"uri"},"pageUrl":{"type":"string","format":"uri"},"tsdrUrl":{"type":"string","format":"uri"},"isRegistered":{"type":"boolean"}}}}}}