|
and Register
Home
Contact Us

Patent Legal Data [P030]Pledge

[P030]PledgePublicV1
Receive pledge data by patent_id or patent_number. This includes pledge contract number, effective date, pledgee, pledger, and pledge type.
Note: The API supports batch requests with a maximum of 100 patents, and more patent id or patent number are separated with English comma. Batch requests are deducted from traffic/costs, and will be deducted multiple times based on the number of successful results returned.

Basic Information

Resource URL: /advanced-patent-data/pledge-data

Request Mode: get

Return Format: application/json

The API can only be called after logging in, click to log in

API Description Document Download

Request Parameters

query
ParameterTypeRequiredDescriptionSample
patent_idstringfalse
patent_id
a6a372dc-2b2c-476b-b1e4-78fab3dce33a
patent_numberstringfalse
patent_number
US11379121B2

Request Sample

  • Curl
  • NodeJs
  • Python
  • Java
curl -X GET "https://connect.patsnap.com/advanced-patent-data/pledge-data?patent_id=a6a372dc-2b2c-476b-b1e4-78fab3dce33a&patent_number=US11379121B2&apikey="
-H "Content-Type:application/json"
-H "authorization:Bearer {token}"
const axios = require('axios');
const options = {
    url: "https://connect.patsnap.com/advanced-patent-data/pledge-data",
    method: "GET",
    headers: {
        'Content-Type': 'application/json',
        'authorization': 'Bearer {token}',
    },
    params: {
        'patent_id': 'a6a372dc-2b2c-476b-b1e4-78fab3dce33a',
        'patent_number': 'US11379121B2',
        'apikey': '',
    },
};
axios(options).then(res => {
    console.log(res.data)
}).catch(err => {
    console.log(err)
})
import requests
url = "https://connect.patsnap.com/advanced-patent-data/pledge-data"

params = {
    "patent_id": "a6a372dc-2b2c-476b-b1e4-78fab3dce33a",
    "patent_number": "US11379121B2",
    "apikey": ""
}

payload = None

headers = {
    "Content-Type": "application/json",
    "authorization": "Bearer {token}"
}

response = requests.request("GET", url, params=params, data=payload, headers=headers)

print(response.text)
public static void main(String[] args) {
    String host = "https://connect.patsnap.com";
    String path = "/advanced-patent-data/pledge-data";

    Map headers = new HashMap();
    headers.put("Content-Type", "application/json");
    headers.put("authorization", "Bearer {token}");

    Map querys = new HashMap();
    querys.put("patent_id", "a6a372dc-2b2c-476b-b1e4-78fab3dce33a");
    querys.put("patent_number", "US11379121B2");
    querys.put("apikey", "");
    try {
        /**
        * Important Tips:
        * Please Download HttpUtils From
        * https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java
        *
        * Please refer to the corresponding dependence:
        * https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml
        */
        HttpResponse response = HttpUtils.doGet(host, path, null, headers, querys);
        System.out.println(EntityUtils.toString(response.getEntity()));
    } catch (Exception e) {
        e.printStackTrace();
    }
}
Copy

Response Parameters

CommonResponse
ParameterTypeRequiredDescriptionSample
data
arrayfalse
response data
no sample
status
booleantrue
Status
false
error_msg
stringfalse
Error Message
The request parameter format is incorrect!
error_code
integertrue
Error Code
0
PatentPledgeDataResponse
ParameterTypeRequiredDescriptionSample
pn
stringfalse
patent number
US11205304B2
patent_id
stringfalse
patent id
718ead9c-4f3c-4674-8f5a-24e126827269
patent_pledge_data
arrayfalse
pledge data
Please check the form: PatentPledgeData
PatentPledgeData
ParameterTypeRequiredDescriptionSample
country
stringfalse
Authority code
US
pledgees
arrayfalse
pledgees
Please check the form: PersonBaseDoc
pledgors
arrayfalse
pledgors
Please check the form: PersonBaseDoc
reel_frame
stringfalse
Pledge contract number
060332/0740
pledge_type
stringfalse
Pledge type
RELEASE OF SECURITY INTEREST IN PATENTS PREVIOUSLY RECORDED AT REEL/FRAME (054475/0434)
effective_date
integerfalse
Pledge effective date
20220610
PersonBaseDoc
ParameterTypeRequiredDescriptionSample
lang
stringfalse
Language
EN
name
stringfalse
name
EMC IP HOLDING COMPANY LLC
sequence
integerfalse
sequence
1
PersonBaseDocPledge
ParameterTypeRequiredDescriptionSample
lang
stringfalse
Language
EN
name
stringfalse
name
EMC IP HOLDING COMPANY LLC
sequence
integerfalse
sequence
1
effective_date_us
integerfalse
Pledge effective date of US
20181029

Response Error Details

error_codeDescription
0Success
401Unauthorized
403Forbidden
404Not Found
68300004Invalid parameter!
68300005Search api failure!
68300006Analytic basic access error!
68300007Bad request!
68300008Service error, please try again later!
68300010The file does not comply with upload specifications!
67200001API call exceeds the total limit set by the platform!
67200002Quota exceeds the limit!
67200003Access token expired or authentication error!
67200004No permission or API package quota has exceeded the limit!
67200005Insufficient balance, call failed!
67200006This client has expired and call failed!

Response Body

  • json
{
    "data": [
        {
            "pn": "US11205304B2",
            "patent_id": "718ead9c-4f3c-4674-8f5a-24e126827269",
            "patent_pledge_data": [
                {
                    "country": "US",
                    "pledgees": [
                        {
                            "lang": "EN",
                            "name": "EMC IP HOLDING COMPANY LLC",
                            "sequence": 1
                        }
                    ],
                    "pledgors": [
                        {
                            "lang": "EN",
                            "name": "EMC IP HOLDING COMPANY LLC",
                            "sequence": 1,
                            "effective_date_us": 20181029
                        }
                    ],
                    "reel_frame": "060332/0740",
                    "pledge_type": "RELEASE OF SECURITY INTEREST IN PATENTS PREVIOUSLY RECORDED AT REEL/FRAME (054475/0434)",
                    "effective_date": 20220610
                }
            ]
        }
    ],
    "status": true,
    "error_code": 0
}
Copy
[P029]Transfer
[P031]Customs record