---
title: "B003 Motif Sequence Search"
method: POST
path: "/bio-openapi/sequence/motif/job"
tags: ["LS Search"]
---

# B003 Motif Sequence Search

`POST /bio-openapi/sequence/motif/job`

## Request

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

Search sequences with motif expression.

## Request body

- B003MotifJobRequest
  - `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
  - `motif_sequence` string, required: Query Motif Sequence
  - `params` B003MotifJobOpenApiMotifParameter, required
    - `filter` B003MotifJobOpenApiMotifFilterParameter
      - `scov_hsp_perc` B003MotifJobOpenAPiNumberRangeParameter
        - `end` integer: End value
        - `start` integer: Start value
      - `subject_length` B003MotifJobOpenAPiNumberRangeParameter
        - `end` integer: End value
        - `start` integer: Start value
  - `query_type` string, required: Target Sequence Type. NUCLEOTIDE,PROTEIN
  - `sequence_type` string, required: Query Sequence Type. NUCLEOTIDE,PROTEIN

## Response `200`

Successful b003 motif sequence search response.

- B003MotifJobResponse
  - `data` B003MotifJobOpenApiResponseSequenceInfo[]: 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)
