---
title: "L012 Literature Citation"
method: POST
path: "/literature/citation"
tags: ["Literature Data"]
---

# L012 Literature Citation

`POST /literature/citation`

## Request

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

Receive literature citation data by paper_id or doi.

## Request body

- L012LiteratureCitationRequest
  - `doi` string: DOI (only a single doi issupported)
  - `page_number` integer: Current page number
  - `paper_id` string: paper id

## Response `200`

Successful l012 literature citation response.

- L012LiteratureCitationResponse
  - `data` L012LiteratureCitationCitationResponse[]: response data
    - `doi` string: DOI
    - `paper_id` string: Paper ID
    - `reference_no` integer: Number of References
    - `np_citation_no` integer: Number of Non-patent Citations
    - `reference_data` L012LiteratureCitationLiteratureReference[]: Reference Data
      - `paper_id` string: Paper ID
      - `sequence` integer: Sequence
      - `citation_text` string: Citation Text
    - `np_citation_data` L012LiteratureCitationLiteratureNPCitation[]: Non-patent Citation data
      - `paper_id` string: Paper ID
      - `citation_text` string: Citation Text
    - `patent_citation_no` integer: Number of Patent Citations
    - `patent_citation_data` L012LiteratureCitationLiteraturePatentCitation[]: Patent Citation Data
      - `pn` string: Patent Number
      - `apdt` integer: Application Date
      - `apno` string: Application Number
      - `pbdt` integer: Publication Date
      - `title` string: Title
      - `inventor` unknown[]: Inventor
        - unknown
      - `patent_id` string: Patent ID
      - `current_assignee` unknown[]: Current Assignee
        - unknown
      - `original_assignee` unknown[]: Original Assignee
        - unknown
  - `status` boolean, required: Status
  - `error_msg` string: Error Message
  - `error_code` integer, required: Error Code

## Other responses

- `201`: Created.
- `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)
