---
title: "P030 Pledge"
method: GET
path: "/advanced-patent-data/pledge-data"
tags: ["Patent Legal Data"]
---

# P030 Pledge

`GET /advanced-patent-data/pledge-data`

## Request

- Base URL: `https://connect.patsnap.com`
- URL: `https://connect.patsnap.com/advanced-patent-data/pledge-data`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/patsnap/apis/patsnap-open-platform-api/docs/advanced-patent-data/pledge-data/get.ts> (a function with typed inputs; its response is checked against the schema)

Receive pledge data by patent_id or patent_number. This includes pledge contract number, effective date, pledgee, pledger, and pledge type.

## Query parameters

- `patent_id` string: patent_id
- `patent_number` string: patent_number

## Response `200`

Successful p030 pledge response.

- P030AdvancedPatentDataPledgeDataResponse
  - `data` P030AdvancedPatentDataPledgeDataPatentPledgeDataResponse[]: response data
    - `pn` string: patent number
    - `patent_id` string: patent id
    - `patent_pledge_data` P030AdvancedPatentDataPledgeDataPatentPledgeData[]: pledge data
      - `country` string: Authority code
      - `pledgees` P030AdvancedPatentDataPledgeDataPersonBaseDoc[]: pledgees
        - `lang` string: Language
        - `name` string: name
        - `sequence` integer: sequence
      - `pledgors` P030AdvancedPatentDataPledgeDataPersonBaseDocPledge[]: pledgors
        - `lang` string: Language
        - `name` string: name
        - `sequence` integer: sequence
        - `effective_date_us` integer: Pledge effective date of US
      - `reel_frame` string: Pledge contract number
      - `pledge_type` string: Pledge type
      - `effective_date` integer: Pledge effective date
  - `status` boolean, required: Status
  - `error_msg` string: Error Message
  - `error_code` integer, required: Error Code

## Other responses

- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: Not Found.

---

[API](https://skmtc.dev/patsnap/apis/patsnap-open-platform-api.md) - [All operations](https://skmtc.dev/patsnap/apis/patsnap-open-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/patsnap/apis/patsnap-open-platform-api/revisions/c2264a0de595?raw)