...
Info | ||
---|---|---|
| ||
Members denoted with † are not included in default output. See request and response below for parameters needed to include these members in the output. |
Member | Description |
---|---|
ucid | The CLAIMS Direct application unique character identifier (ucid) |
country | The country of filing |
doc_number | The CLAIMS Direct formatted application filing number |
doc_number_original | The original formatted, national application filing number |
date | The filing date |
kind | The application kind code |
lang | Language of application |
format | fixed: ifi . The format of document numbers and ucids. For exceptions, see doc_number_original |
fam | The simple family identifier |
origin | |
effective | The earliest filing date, which may be the date of the corresponding PCT filing, of an earlier non-provisional parent filing, or may be the same as the filing date listed in the application-reference when no earlier filing exists |
entity_status | US only; Description of filing entity based on number of employees, possible values are micro, small, large, or unknown |
claims_total† | Total number of claims (if available) |
patent_status | A simplified enumeration of the CLAIMS Direct patent status |
relation | Enumeration of relationship (continuation or division ) |
parent | If a continuation or divisional relationship (see relation), this will hold the parent application ucid |
assignee | The current assignee |
pta | Patent term adjustment (extension) in days |
abstract_en† | An English-language abstract, where available, and the original-language abstract (as determined by language of publication) |
description_en† description_original† | Description (as described under abstract_en/abstract_original ) |
claims_en† claims_original† | Claims (as described under abstract_en/abstract_original ) |
Additional members of the tws_application
which contain substructures follows.
Info | ||
---|---|---|
| ||
Members denoted with † are not included in default output. See request and response below for parameters needed to include these members in the output. |
Member | Sub-members | Description | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
inventors† | inventor | An array of all inventors | ||||||||||||||
priority |
| The earliest priority excluding provisional applications | ||||||||||||||
publications |
| An array of all publications tied to the root application number | ||||||||||||||
grant |
| The published granted patent | ||||||||||||||
national_grant |
| The published national granted patent | ||||||||||||||
titles |
| The titles array condenses the title(s) of all stages into a language-distinct array | ||||||||||||||
simple_family† | ucid | An array of ucids which make up a simple family | ||||||||||||||
extended_family† | ucid | An array of ucids which make up the extended inpadoc family | ||||||||||||||
classifications† |
| The classifications array contains all classifications condensed into a unique set per classification type | ||||||||||||||
claims_hierarchy† |
| The claims_hierarchy member outlines the claim dependencies |
Technical Details
Request
There are two request endpoints to tws: an
and dn
(application number lookup and document number lookup respectively).
/custom/tws/[an|dn]
Method | GET | ||
---|---|---|---|
Path | |||
Parameter | Values | Description | |
@id | String: ex. US-5551212[,EP 0700000] | One or more application or document numbers to retrieve. Multiple @ids are separated by commas. | |
@include-optional | Integer: ex. 1 | The default response contains a subset of available content. To include all available content (as denoted above under Content), set this parameter to 1. | |
@include | String: ex. inventors | Include only a subset of optional content. | |
@exclude | String: ex. publications | Exclude particular content. | |
@include-only | String: ex. effective | Includes only the content specified. The top-level ucid member is always included by default. | |
@origin | String: ex. EP or WO | When the origin of an application input is either EP or WO, this parameter should be specified. If there are multiple @ids, input of origin-per-id is accomplished through subscripts. For example, assume two input ids /custom/tws/an?id=US13/123456,FR12345678 You could specify
If | |
@date | Integer: ex. 19960101 | If given, this parameter increases performance and confidence in the input-matching process. The same method of explicitly targeting a specific input with
|
Response
The tws response comes in two formats: JSON (the default) and XML (HTTP header: Accept:text/xml). For illustration purposes, the examples below show only JSON. The structure of the response is identical, with the exception of the following JSON-specific contructs:
...
The response container contains meta information pertaining to the result of the request.
Member | Description |
---|---|
method | The endpoint used to create this response |
time | Time in seconds of the entire request/response |
status | Enumeration: success or error |
error | In the case of status=error , a message will describe the error. |
content
Container
The content
member of the response contains the body. It is an anonymous structure whose key is the input id. When multiple ids are given as input, this structure will have multiple keys. The value of the structure is an anonymous structure containing meta information and the core object, the tws_applications
array.
Code Block |
---|
"content" : { "US-08/25828" : { "iid" : "US-08/25828", "lookup_status" : "found", "confidence" : 100, "tws_applications" : [ ] } } |
Member | Description |
---|---|
iid | The exact input given (input-id) |
lookup_status | Enumeration of found , not-found or found-duplicate |
confidence | A confidence level (0-100) of the input <=> output match. This is currently fixed at 100. |
tws_applications
Container
...