Search DNA Sequences

POST

https://{tenant_name}.benchling.com/api/v2/dna-sequences:search-bases

POST

/api/v2/dna-sequences:search-bases

curl -X POST https://{tenant_name}.benchling.com/api/v2/dna-sequences:search-bases \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "bases": "GATTACAA"
}'

{
  "dnaSequences": [
    {
      "aliases": [
        "string"
      ],
      "annotations": [
        {
          "color": "#F58A5E",
          "customFields": [
            {
              "name": "string",
              "value": "string"
            }
          ],
          "name": "string",
          "notes": "Cong et al Science. 2013 Jan 3.",
          "end": 1,
          "start": 1,
          "strand": 1,
          "type": "string"
        }
      ],
      "apiURL": "https://benchling.com/api/v2/dna-sequences/seq_asQya4lk",
      "archiveRecord": {
        "reason": "Made in error"
      },
      "authors": [
        {
          "handle": "string",
          "id": "string",
          "name": "string"
        }
      ],
      "bases": "string",
      "createdAt": "2024-01-15T09:30:00Z",
      "creator": {
        "handle": "string",
        "id": "string",
        "name": "string"
      },
      "customFields": {
        "Legacy ID": {
          "value": "STR100"
        }
      },
      "dnaAlignmentIds": [
        "string"
      ],
      "entityRegistryId": "string",
      "fields": {},
      "folderId": "string",
      "id": "string",
      "isCircular": true,
      "length": 1,
      "modifiedAt": "2024-01-15T09:30:00Z",
      "name": "string",
      "parts": [
        {
          "end": 1,
          "sequenceId": "seq_VfVOART1",
          "start": 1,
          "strand": 1
        }
      ],
      "primers": [
        {
          "bases": "string",
          "bindPosition": 1,
          "color": "string",
          "end": 1,
          "name": "string",
          "oligoId": "string",
          "overhangLength": 1,
          "start": 1,
          "strand": 1
        }
      ],
      "registrationOrigin": {
        "originEntryId": "string",
        "registeredAt": "2024-01-15T09:30:00Z"
      },
      "registryId": "string",
      "schema": {
        "id": "string",
        "name": "string"
      },
      "transcriptions": [
        {
          "end": 1,
          "sequenceId": "seq_VfVOART1",
          "start": 1,
          "strand": 1
        }
      ],
      "translations": [
        {
          "color": "#F58A5E",
          "customFields": [
            {
              "name": "string",
              "value": "string"
            }
          ],
          "name": "string",
          "notes": "Cong et al Science. 2013 Jan 3.",
          "aminoAcids": "string",
          "coerceStartCodonToMethionine": false,
          "end": 1,
          "geneticCode": "STANDARD",
          "regions": [
            {
              "end": 1,
              "start": 1
            }
          ],
          "start": 1,
          "strand": 1
        }
      ],
      "url": "string",
      "webURL": "string"
    }
  ],
  "nextToken": "string"
}

Returns DNA Sequences that contain the provided bases. Search indexing is asynchronous, so results my be not be available immediately after creation.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

basesstringRequired>=8 characters

archiveReasonenumOptionalDefaults to NOT_ARCHIVED

Allowed values:

nextTokenstringOptional

pageSizeintegerOptional0-100Defaults to 50

registryIdstring or nullOptional

ID of a registry. Restricts results to those registered in this registry. Specifying null returns unregistered items.

schemaIdstringOptional

ID of the nucleotide sequence's schema.

sortenumOptionalDefaults to modifiedAt:desc

Allowed values:

Response

A filtered list of DNA Sequences

dnaSequenceslist of objectsOptional

nextTokenstringOptional

Errors

400

Bad Request Error