---
title: "P031 Customs record"
method: GET
path: "/advanced-patent-data/customs-data"
tags: ["Patent Legal Data"]
---

# P031 Customs record

`GET /advanced-patent-data/customs-data`

## Request

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

Receive customs data by patent_id or patent_number. This includes record number, record status, start date, end date, approval/opinion, product, and contact.

## Query parameters

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

## Response `200`

Successful p031 customs record response.

- P031AdvancedPatentDataCustomsDataResponse
  - `data` P031AdvancedPatentDataCustomsDataPatentCustomsDataResponse[]: response data
    - `pn` string: patent number
    - `patent_id` string: patent id
    - `patent_customs_record_data` P031AdvancedPatentDataCustomsDataPatentCustomsRecordData[]: customs data
      - `contact` string: Contact
      - `country` string: Authority code
      - `product` string: product
      - `end_date` integer: Record end date
      - `start_date` integer: Record start date
      - `record_number` string: Record number
      - `record_status` string: Record status
      - `approval_opinion` string: Approval opinion
  - `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)