---
title: "B062 Extract Single Patent Sequence"
method: POST
path: "/bio-openapi/patent/extract/single"
tags: ["Chemical and Bio Data"]
---

# B062 Extract Single Patent Sequence

`POST /bio-openapi/patent/extract/single`

## Request

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

Extract all sequences from a single patent and provide the total count, sequence numbers, sequence codes, and sequence details. Present the information in a paginated format.

## Request body

- B062ExtractSingleRequest
  - `extract_type` string, required: Extract Type(EXTRACT_ALL、EXTRACT_RANGE、EXTRACT_NUM、EXTRACT_MANUAL)
  - `page` integer, required: Current page number, start from 1
  - `patent_id` string: Patent ID
  - `patent_number` string: Patent publication number. One of patent_number、patent_id must be filled in, and if they are filled in at the same time, patent_id shall prevail, followed by patent_number
  - `sequence_length` B062ExtractSingleOpenAPiNumberRangeParameter
    - `end` integer: End value
    - `start` integer: Start value
  - `sequence_no_range` string, required: SEQ ID range(Example:1-10,23,24)
  - `sequence_type` string: Sequence Type, PROTEIN or NUCLEOTIDE
  - `size` integer, required: Current page result size, support maximum 100

## Response `200`

Successful b062 extract single patent sequence response.

- B062ExtractSingleResponse
  - `data` B062ExtractSingleExtractResults
    - `total` integer: Query Results Count
    - `results` B062ExtractSingleOpenApiExtractHit[]: Query Results
      - `s_len` integer: Subject sequence length
      - `seq_id` string: Sequence ID
      - `location` object: Sequence location in patent
      - `s_sequence` string: Subject sequence
      - `sequence_type` string: Sequence Type, PROTEIN or NUCLEOTIDE
      - `sequence_id_number` unknown[]: Sequence ID number in patent
        - 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)