Legal Status

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

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


/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

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

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

Response (abbreviated)

{
   "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

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

Response (abbreviated)

{
   "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"
         }
     ]
  }
}