---
title: "P015 Cited By Patents（Beta）"
method: GET
path: "/basic-patent-data/forward-citation/v3"
tags: ["Patent Basic Data"]
---

# P015 Cited By Patents（Beta）

`GET /basic-patent-data/forward-citation/v3`

## Request

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

Query a specific patent’s cited by other patents via patent_id or patent_number, including: citing country/region/organization, cited patent document number/code, citation counts in simple/INPADOC/Patsnap patent families.

## Query parameters

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

## Response `200`

Successful p015 cited by patents（beta） response.

- P015ForwardCitationV3Response
  - `data` P015ForwardCitationV3PatentCitedV2Response[]: response data
    - `pn` string: patent number
    - `patent_id` string: patent id
    - `patent_cited` P015ForwardCitationV3PatentCitedV2
      - `cited_by_3y` integer: Count of cited by patents within 3 years
      - `cited_by_5y` integer: Count of cited by patents within 5 years
      - `cited_by_patents` P015ForwardCitationV3CitedByPatentsV2[]: cited by patents
        - `pn` string: patent number
        - `apdt` integer: Application Date
        - `apno` string: application number
        - `kind` string: kind code
        - `pbdt` integer: Publication Date
        - `title` string: Title
        - `country` string: citation authority
        - `category` unknown[]: citation category
          - unknown
        - `inventor` string: Inventor
        - `sequence` integer: sequence
        - `cite_type` unknown[]: Citation type:<p>APP - applicant，EXA - examiner，OPP - opposition，TPO - third party observation，OTHER - others</p>
          - unknown
        - `doc_number` string: doc number
        - `current_assignee` string: Current Assignee
        - `original_assignee` string: Original Assignee (Applicant)
      - `cited_by_simple_family` integer: Simple family backward citation count
      - `cited_by_inpadoc_family` integer: INPADOC family backward citation count
      - `cited_by_patsnap_family` integer: PATSNAP family backward citation count
  - `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)