---
title: "List Entry items"
method: GET
path: "/api/v3/entry/items"
tags: ["Entry"]
---

# List Entry items

`GET /api/v3/entry/items`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/entry/items`
- Auth: HTTP bearer

List Entry items.

## Query parameters

- `archiveReason.anyOf` string[]
- `archived.anyOf` boolean[]
- `authors.anyOf` string[]
- `createdAt.gt` string, datetime
- `createdAt.gte` string, datetime
- `createdAt.lt` string, datetime
- `createdAt.lte` string, datetime
- `creator.anyOf` string[]
- `id.anyOf` string[]
- `mentionedIn.anyOf` string[]
- `mentions.anyOf` string[]
- `modifiedAt.gt` string, datetime
- `modifiedAt.gte` string, datetime
- `modifiedAt.lt` string, datetime
- `modifiedAt.lte` string, datetime
- `name.anyOf` string[]
- `name.anyOf.caseSensitive` string[]
- `nextToken` string
- `omit` string[]
- `pageSize` integer
- `project.eq` string
- `returning` string[]
- `schema.anyOf` string[]
- `schema.eq` string
- `sort` 'createdAt:asc' | 'createdAt:desc' | 'modifiedAt:asc' | 'modifiedAt:desc'

## Headers

- `EARLY-ACCESS` string

## Response `200`

OK

- EntryPaginatedList
  - `items` Entry[]
    - `__typename` string
    - `applicableReviewProcesses` string, uri: Lists review processes configured for the entry's project. Use the paginated list of applicable review processes for the full list including stages and version details.
    - `archiveReason` string, nullable: Specifies the archive reason when the entry is archived.
    - `archived` boolean: Specifies whether the entry is archived.
    - `createdAt` string, datetime, nullable: Specifies when the entry was created.
    - `customFields` CustomField[], nullable: Lists custom field values on the entry.
      - `__typename` string
      - `name` string, nullable
      - `value` string, nullable
    - `displayId` string, nullable: Specifies the display ID for the entry.
    - `folder` FolderRef
      - `__typename` string
      - `id` string, api_id
    - `id` string: Identifies the entry.
    - `modifiedAt` string, datetime, nullable: Specifies when the entry was last modified.
    - `name` string, nullable: Specifies the title of the entry.
    - `review` ReviewRef
      - `__typename` string
      - `id` string, api_id
    - `reviewSource` ProjectRef
      - `__typename` string
      - `id` string, api_id
    - `schema` EntrySchemaRef
      - `__typename` string
      - `id` string, api_id
    - `selectors` TableCellSelector[]: Lists dropdown selectors available to table cells in the document.
      - `__typename` string
      - `name` string: Specifies the display name of the selector.
      - `options` string[]: Lists the allowed dropdown option values.
      - `selectorId` string: Specifies the selector identifier within the document. Matches the selectorId field on table cells.
    - `typedSchema` EntrySchemaRef
      - `__typename` string
      - `id` string, api_id
    - `versionMetadata` DocumentLikeVersionMetadata: Version metadata for a document such as an entry, template, or subtemplate. Identifies a specific content revision and records when that revision was produced. Use this to detect changes, pin a revision, or reference a particular version without loading the full version record.
      - `__typename` string
      - `createdAt` string, datetime, nullable: Specifies when this version was created. Versions are immutable; this is the time the parent document was last edited to produce this revision.
      - `versionId` string: Identifies this version of the document.
    - `webUrl` string: Specifies the absolute URL of the entry in the Benchling web app.
    - `authors` string, uri, nullable: Lists the authors of the entry. Defaults to the creator but may be edited.
    - `creator` PrincipalRef
      - `__typename` string
      - `id` string, api_id
    - `parts` string, uri: Lists ordered document parts that make up the document content.
    - `schemaFields` SchemaFieldValue[], nullable: Lists values for fields defined by the entry schema.
      - `__typename` string
      - `fieldDefinition` SchemaFieldDefinitionRef
        - `__typename` string
        - `id` string, api_id
      - `id` string
      - `linkedEntityId` string, nullable
      - `value` union: Types of values that Benchling can interpret.
        - object: A type that represents a list of BenchlingValues, used for multi-value cells (e.g. alias columns).
          - `__typename` 'ArrayValue', required: Discriminator value: ArrayValue
          - `value` SingularBenchlingValue[]
            - union: A union of value types that can appear as elements within an ArrayValue. Identical to BenchlingValue but excludes ArrayValue to prevent nesting. Keep in sync with BenchlingValue.
              - …
        - object: A type that represents boolean values.
          - `__typename` 'BooleanValue', required: Discriminator value: BooleanValue
          - `value` boolean: The boolean value.
        - object: A type that represents datetime values.
          - `__typename` 'DateTimeValue', required: Discriminator value: DateTimeValue
          - `value` string, datetime: The datetime value with UTC as the timezone.
        - object: A type that represents date values.
          - `__typename` 'DateValue', required: Discriminator value: DateValue
          - `value` string, date: The date value.
        - object: A type that represents decimal value as strings.
          - `__typename` 'DecimalValue', required: Discriminator value: DecimalValue
          - `numericValue` number, double, nullable: Deprecated. The float representation of the decimal value.
          - `value` string, nullable: The decimal value in a string representation
        - object: A type that represents integer values.
          - `__typename` 'IntegerValue', required: Discriminator value: IntegerValue
          - `value` integer: The integer value.
        - object: A type that represents JSON values.
          - `__typename` 'JsonValue', required: Discriminator value: JsonValue
          - `value` union: The JSON value.
            - object
            - string[]
            - string
            - number, double
            - boolean
        - object: A type that represents a list of links to other objects.
          - `__typename` 'ObjectLinkListValue', required: Discriminator value: ObjectLinkListValue
          - `value` LinkableDomainObject[]: The list of objects that this value links to. Inaccessible objects may be returned instead if the object is not found with the current permission set.
            - union: A union representing items that can be linked to. If you have a type that can be linked to, it can only be added once it's in beta.
              - …
        - object: A type that represents links to other objects.
          - `__typename` 'ObjectLinkValue', required: Discriminator value: ObjectLinkValue
          - `value` union: A union representing items that can be linked to. If you have a type that can be linked to, it can only be added once it's in beta.
            - object: AaSequence variant
              - …
            - object: Attachment variant
              - …
            - object: Box variant
              - …
            - object: Container variant
              - …
            - object: CustomEntity variant
              - …
            - object: DnaOligo variant
              - …
            - object: DnaSequence variant
              - …
            - object: DropdownOption variant
              - …
            - object: Entry variant
              - …
            - object: Inaccessible variant
              - …
            - object: Location variant
              - …
            - object: MatrixPlate variant
              - …
            - object: Mixture variant
              - …
            - object: Molecule variant
              - …
            - object: OligoConjugate variant
              - …
            - object: OligoDuplex variant
              - …
            - object: Protein variant
              - …
            - object: Result variant
              - …
            - object: RnaOligo variant
              - …
            - object: RnaSequence variant
              - …
            - object: Run variant
              - …
            - object: WellPlate variant
              - …
        - object: A type that represents text (string) values with an associated URL.
          - `__typename` string, required
          - `url` string: The URL associated with the value. Please use `TextValue` if you don't want a URL.
          - `value` string: The text value. It may or may not be an empty string.
        - object: A type that represents text (string) values.
          - `__typename` string, required
          - `value` string: The text value. It may or may not be an empty string.
  - `nextToken` string, nullable

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/benchling/apis/benchling-api.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api/revisions/c9f087b98b8b?raw)
