---
title: "P032 Award"
method: GET
path: "/advanced-patent-data/award-data"
tags: ["Patent Legal Data"]
---

# P032 Award

`GET /advanced-patent-data/award-data`

## Request

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

Receive award data by patent_id or patent_number. This includes award name, level, session, referrer, and type.

## Query parameters

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

## Response `200`

Successful p032 award response.

- P032AdvancedPatentDataAwardDataResponse
  - `data` P032AdvancedPatentDataAwardDataPatentAwardDataResponse[]: response data
    - `pn` string: patent number
    - `patent_id` string: patent id
    - `patent_award_data` P032AdvancedPatentDataAwardDataPatentAwardData[]: award data
      - `category` string: Award type
      - `award_name` string: Award name, including CN patent awards of several provinces/cities and European Inventor Award
      - `award_level` string: Award level, only CN jurisdiction have this field
      - `award_session` string: Award session
      - `award_referrer` string: Award referrer, only CN jurisdiction have this field
  - `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)