---
title: "P013 Patent Legal Status"
method: GET
path: "/basic-patent-data/legal-status"
tags: ["Patent Basic Data"]
---

# P013 Patent Legal Status

`GET /basic-patent-data/legal-status`

## Request

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

Receive legal status data by patent_id or patent_number. Legal status data includes simple legal status, legal status and event status. For more details please view the fields description in the developer document.

## Query parameters

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

## Response `200`

Successful p013 patent legal status response.

- P013BasicPatentDataLegalStatusResponse
  - `data` P013BasicPatentDataLegalStatusPatentLegalStatusResponse[]: response data
    - `pn` string: patent number
    - `patent_id` string: patent id
    - `patent_legal` P013BasicPatentDataLegalStatusPatentLegalStatus
      - `event_status` unknown[]: Event status: <p>such as: Transfer,License,Pledge,Trust,Opposition,Re-examination,Customs,Litigation,Preservation,Invalid-procedure,Oral-procedure,Declassification,Double application</p>
        - unknown
      - `legal_status` unknown[]: Legal status:<p>such as: Published,Examining,Granted,Double,Abandoned-Undetermined,Abandoned-Voluntarily,Abandoned-Deemed,Withdrawn-Undetermined,Withdrawn-Voluntarily,Withdrawn-Deemed,Rejected,Revoked,Expired,Non-Payment,Restoration,Ceased,P-Revoked,Discontinuation,PCT published,PCT entering(designated period),PCT entering(designated expiration),unentered</p>
        - unknown
      - `simple_legal_status` unknown[]: Simple legal status: <p>such as: Inactive,Active,Pending,Undetermined,PCT designated period,PCT designated expiration</p>
        - unknown
  - `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)