Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 9

The Legal Status service exposes legal events from the USPTO PAIR data as well as EPO and the EPO's INPADOC.

Warning

This service is currently BETA. Request parameters and response formats may change.

Table of Contents

/legalstatus/uspto

This service provides transaction histories from the USPTO PAIR data.

MethodGET
Path/legalstatus/uspto
Parameter
 

ValuesDescription
 

@ucidString, e.g., US-5551212-AThe unique character identifier of the publication
 

@anucidString, e.g., US-2582893-AUnique filing identifier
 

@anorigString, e.g., US-08025828Original filing number

...


Example

Code Block
wget -O- -q \
  --header 'x-user:x' --header 'x-password:y' \
'httphttps://cdws21.ificlaims.com/legalstatus/uspto?ucid=US-5551212-A'
 
wget -O- -q \
  --header 'x-user:x' --header 'x-password:y' \
'httphttps://cdws21.ificlaims.com/legalstatus/uspto?anucid=US-2582893-A'

wget -O- -q \
  --header 'x-user:x' --header 'x-password:y' \
'httphttps://cdws21.ificlaims.com/legalstatus/uspto?anorig=US-08025828'

Response (abbreviated)

Code Block
languagetext
{
   "time" : "0.240",
   "status" : "success",
   "content" : {
      "uspto" : {
         "ucids" : [
            "US-5551212-A"
         ],
         "anorig" : "US-08025828",
         "anucid" : "US-2582893-A",
         "events" : [
            {
               "country" : "US",
               "title" : "Patented Case",
               "code" : "FOND",
               "description" : "Case Found",
               "date" : 20000710
            },
            {
               "code" : "LOST",
               "country" : "US",
               "title" : "Patented Case",
               "description" : "Case Reported Lost",
               "date" : 20000710
            },
...
            {
               "code" : "DOCK",
               "country" : "US",
               "title" : "Patented Case",
               "description" : "Case Docketed to Examiner in GAU",
               "date" : 19930707
            },
            {
               "description" : "Application Captured on Microfilm",
               "date" : 19930511,
               "code" : "FILM",
               "country" : "US",
               "title" : "Patented Case"
            }
         ],
         "anorig" : "US-08025828",
         "ucids" : [
            "US-5551212-A"
         ]
      }
   }
}


/legalstatus/epo

This service provides event histories from EPO INPADOC data.

MethodGET
Path/legalstatus/epo
Parameter
ValuesDescription

@ucidString, e.g., EP-3130609-B9The unique character identifier of the publication


Example

Code Block
wget -O- -q \
  --header 'x-user:x' --header 'x-password:y' \
'https://cdws21.ificlaims.com/legalstatus/epo?ucid=EP-3130609-B9'

Response (abbreviated)

Code Block
languagetext
{
   "time" : "0.181",
   "status" : "success",
   "content" : {
      "epo" : [
         {
            "country" : "EP",
            "date" : "20201117",
            "title" : "REFERENCE TO A NATIONAL CODE",
            "attributes" : [
               "Kind Code of Ref Document: A1",
               "Designated State(s): AL AT BE BG CH CY CZ DE DK EE ES FI FR GB GR HR HU IE IS IT LI LT LU LV MC MK MT NL NO PL PT RO RS SE SI SK SM TR"
            ],
            "code" : "REG"
         },
         {
            "country" : "EP",
            "date" : "20201115",
            "title" : "REFERENCE TO A NATIONAL CODE",
            "attributes" : [
               "Kind Code of Ref Document: A1",
               "Designated State(s): AL AT BE BG CH CY CZ DE DK EE ES FI FR GB GR HR HU IE IS IT LI LT LU LV MC MK MT NL NO PL PT RO RS SE SI SK SM TR"
            ],
            "code" : "REG"
         },
         {
            "country" : "EP",
            "date" : "20201113",
            "title" : "REFERENCE TO A NATIONAL CODE",
            "attributes" : [
               "Kind Code of Ref Document: A1",
               "Designated State(s): AL AT BE BG CH CY CZ DE DK EE ES FI FR GB GR HR HU IE IS IT LI LT LU LV MC MK MT NL NO PL PT RO RS SE SI SK SM TR"
            ],
            "code" : "REG"
         }
     ]
  }
}