Per the notice at the top of TDR:
On August 25, 2012, the USPTO released version 2.0 of Trademark Status and Document Retrieval (TSDR). On September 1st, all existing direct (static) hyper-links displaying TARR information will be redirected to TSDR. On September 8th, all existing direct (static) hyper-links displaying TDR information will be redirected to TSDR. Soon thereafter, the web pages at http://tarr.uspto.gov/ and http://tdr.uspto.gov/ will no longer be accessible. Please send any questions to TSDR@USPTO.GOV. Additional information about the TSDR 2.0 deployment is available here: TSDR 2.0.
There is an API for the new TSDR, but I haven’t seen much documentation beyond the examples that were mentioned in the TSDR 2.0 FAQ:
- Status for serial number 78787878 as a pdf – http://tdrapi.uspto.gov/ts/cd/casestatus/sn78787878/download.pdf
- Status for serial number 78787878 as a zip that includes XML and CSS files – http://tdrapi.uspto.gov/ts/cd/casestatus/sn78787878/download.zip
- All documents for Serial Number 72131351 as a PDF – http://tdrapi.uspto.gov/ts/cd/casedocs/bundle.pdf?sn=72131351
- All documents for Reference Number Z1231384 as a PDF – http://tdrapi.uspto.gov/ts/cd/casedocs/bundle.pdf?ref=Z1231384
- All documents for Registration Number 3,500,030 as a PDF – http://tdrapi.uspto.gov/ts/cd/casedocs/bundle.pdf?rn=3500030
- Documents sent/received on Nov 30th, 2003 for Serial Number 72-131351 as a PDF – http://tdrapi.uspto.gov/ts/cd/casedocs/bundle.pdf?sn=72131351&date=2003-11-30
- All specimens for Serial Numbers 72131351 and 76515878 as a single PDF – http://tdrapi.uspto.gov/ts/cd/casedocs/bundle.pdf?sn=72131351,76515878&type=SPE
- Metadata (in XML) about all documents for Serial Number 75008897 sent/received during 2006 – http://tdrapi.uspto.gov/ts/cd/casedocs/bundle.xml?sn=75008897&fromdate=2006-01-01&todate=2006-12-31
- Metadata (in XML) about all documents for International Registration Number 0835690 sorted from earliest to latest – http://tdrapi.uspto.gov/ts/cd/casedocs/bundle.xml?ir=0835690&sort=date:A
- The Registration Certificate for Registration Number 3,500,038 as a PDF – http://tdrapi.uspto.gov/ts/cd/casedocs/bundle.pdf?rn=3500038&category=RC
- The Registration Certificates for Registration Numbers 3,500,038 and 3,500,039 as a ZIP of their original TIFF images – http://tdrapi.uspto.gov/ts/cd/casedocs/bundle.zip?rn=3500038,3500039&category=RC
- Status for Serial Number 78787878 as html – http://tdrapi.uspto.gov/ts/cd/casestatus/sn78787878/content.html
- Status for Serial Number 78787878 as XML – http://tdrapi.uspto.gov/ts/cd/casestatus/sn78787878/info.xml
Please let me know if you’ve seen any other API documentation out there…and I’ll update this post.
[UPDATE 2012-09-04]
I asked the USPTO last week if there was any additional documentation regarding the API. I was told that there is not.
From the above list (and looking at the XML), you can extrapolate the following:
The URLS start with: “http://tdrapi.uspto.gov/ts/cd”
Options include:
/casestatus/sn1234567/download.pdf [[status as a pdf]]
/casestatus/sn1234567/download.zip [[status as zip with xml and css files]]
/casestatus/sn1234567/content.html [[status as html]]
/casestatus/sn1234567/info.xml [[status as xml]]
/casedocs/bundle.pdf?sn=1234567 [[by serial number]]
/casedocs/bundle.pdf?rn=1234567 [[by registration number]]
/casedocs/bundle.pdf?ref=1234567 [[by USPTO reference number]]
/casedocs/bundle.pdf?ir=0835690 [[by international registration number]]
/casedocs/bundle.xml [[metadata in xml]]
/casedocs/bundle.zip [[a ZIP of the original TIFF images]]
&date=1999-01-01 [[docs sent/received on a date]]
&fromdate=2006-01-01&todate=2006-12-31 [[docs sent/received in a date range]]
&type=SPE [[specimens]]
&type=DSC [[Design Search Code]]
&type=ORC [[Registration Certificate]]
&type=DRW [[Drawing]]
&type=NOP [[Notice of Publication]]
&type=APP [[Application]]
&sort=date:A [[sorted from earliers to latest]]
&category=RC [[Registration Certificate]]
multiple matters can be requested by adding them comma separated
/casedocs/bundle.pdf?sn=1234567,2345678
Regarding the “Status for Serial Number” API: have you seen a published XSD or a means to generate one? I have not been able to locate one.
Mike:
I have not.
I emailed the Office and asked them if there was any additional documentation. They indicated that there is not.
I spent some time playing with it Friday, I’ll update the post (above) with the additional information I extrapolated.
Steve
Steve,
From my research, I seem to recall some reference to PTO relying on some open standard in defining the XML format.
Ultimately, I came across the following site which provides an XML schema that really looks like it is the correct one for the XML provided by the PTO:
http://www.tm-xml.org/TM-XML/TM-XML_xml/index.xml
Unfortunately, in my first attempts using JAXB, I was unable to unmarshal that XML.
Do you think this could be the correct schema?
Mike
It was late at night when I was looking at the XSD from TM-XML. Upon closer inspection, it cannot be the schema for the PTO xml file.
Just wanted to say that your post was very useful for this attorney in Michigan. Thank you.
Thanks.