---
title: "B004 Normal Sequence Search"
method: POST
path: "/bio-openapi/sequence/job"
tags: ["LS Search"]
---

# B004 Normal Sequence Search

`POST /bio-openapi/sequence/job`

## Request

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

Search sequences with key information.

## Request body

- B004SequenceJobRequest
  - `database` unknown[]: Target Sequence Database,ALLPATENT (default) : Sequence published in patent title/abstract/claims/description;CLAIMS : Sequence published in patent claims;NONPATENT : Sequence published in non-patent publications
    - unknown
  - `limit` integer, required: Maximum returned results of each query, support maximum 10,000
  - `params` B004SequenceJobOpenApiBlastParameter, required
    - `algorithm` string, required: Blast algorithm. nucleotide searching nucleotide uses megablast, blastn or blastn-short. nucleotide searching protein uses blastx-fast. protein searching protein uses blastp, blastp-fast or blastp-short. protein searching nucleotide uses tblastn-fast.
    - `evalue` number, float: The higher you set this e-value threshold, the more results you are likely to see.E-Value indicates how likely it is that a sequence is similar to yours simply by chance. For instance, if your sequence is very short, there is a higher likelihood that it appears in several locations simply by chance. The greater the e-value, the more likely it is that this is just down to luck.
    - `filter` B004SequenceJobOpenApiFilterParameter
      - `perc_identity` B004SequenceJobOpenAPiNumberRangeParameter
        - `end` integer: End value
        - `start` integer: Start value
      - `q_perc_identity` B004SequenceJobOpenAPiNumberRangeParameter
        - `end` integer: End value
        - `start` integer: Start value
      - `qcov_hsp_perc` B004SequenceJobOpenAPiNumberRangeParameter
        - `end` integer: End value
        - `start` integer: Start value
      - `s_perc_identity` B004SequenceJobOpenAPiNumberRangeParameter
        - `end` integer: End value
        - `start` integer: Start value
      - `scov_hsp_perc` B004SequenceJobOpenAPiNumberRangeParameter
        - `end` integer: End value
        - `start` integer: Start value
      - `subject_length` B004SequenceJobOpenAPiNumberRangeParameter
        - `end` integer: End value
        - `start` integer: Start value
    - `with_gaps` boolean: Matching with or without gaps indicates whether or not you want your sequence alignment to include gaps.
    - `word_size` integer: Length of initial exact match. For nucleotide searching nucleotide valid word sizes are >= 4, others are 2-7. With smaller word size, the matching will be more exact, but the time cost will be longer.
  - `query_type` string, required: Target Sequence Type. NUCLEOTIDE,PROTEIN
  - `sequence_list` B004SequenceJobOpenApiRequestSequenceInfo[], required: Query Sequence, support single input query
    - `label` string: User provided sequence label
    - `sequence` string: User provided sequence
  - `sequence_type` string, required: Query Sequence Type. NUCLEOTIDE,PROTEIN

## Response `200`

Successful b004 normal sequence search response.

- B004SequenceJobResponse
  - `data` B004SequenceJobOpenApiResponseSequenceInfo[]: response data
    - `label` string: User provided sequence label
    - `job_id` string: ID of the search job in backend, use this ID for subsequent API calls
    - `sequence` string: User provided sequence
  - `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)