---
title: "List Mixture items"
method: GET
path: "/api/v3/mixture/items"
tags: ["Mixture"]
---

# List Mixture items

`GET /api/v3/mixture/items`

## Request

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

List Mixture 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[]
- `entityRegistryIds.anyOf` string[]
- `fieldset.anyOf` string[]
- `folder.eq` string
- `id.anyOf` string[]
- `mentionedIn.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
- `registry.eq` string
- `returning` string[]
- `schema.anyOf` string[]
- `schema.eq` string
- `systemCategory.anyOf` string[]
- `sort` 'createdAt:asc' | 'createdAt:desc' | 'modifiedAt:asc' | 'modifiedAt:desc'

## Headers

- `EARLY-ACCESS` string

## Response `200`

OK

- MixturePaginatedList
  - `items` Mixture[]
    - `__typename` string
    - `aliases` string[], nullable
    - `allowMeasuredIngredients` boolean, nullable: Derived from the mixture's schema.
    - `amount` string, nullable: The positive numerical amount value of this mixture in string format (to preserve full precision). Pair with `units`. Supports scientific notation (1.23e4).
    - `archiveReason` string, nullable
    - `archived` boolean
    - `createdAt` string, datetime, nullable
    - `customFields` CustomField[], nullable
      - `__typename` string
      - `name` string, nullable
      - `value` string, nullable
    - `entityRegistryId` string, nullable: The registry-assigned identifier for this item (e.g. its registry ID shown in the UI), present only once the item has been registered. Null if the item is not registered.
    - `folder` FolderRef
      - `__typename` string
      - `id` string, api_id
    - `id` string
    - `ingredients` Ingredient[], nullable: List of ingredients on this mixture.
      - `__typename` string
      - `amount` string, nullable: The amount value of this ingredient in its mixture, in string format (to preserve full precision). Pair with `units`. Supports scientific notation (1.23e4). One ingredient on this mixture can have an amount value of `"QS"`.
      - `catalogIdentifier` string, nullable
      - `componentEntity` EntityRef
        - `__typename` string
        - `id` string, api_id
      - `componentLotContainer` ContainerRef
        - `__typename` string
        - `id` string, api_id
      - `componentLotEntity` EntityRef
        - `__typename` string
        - `id` string, api_id
      - `componentLotText` string, nullable: Text representing the component lot for this ingredient. This is only present if the mixture schema supports component lots in "text" format.
      - `hasParent` boolean, nullable
      - `notes` string, nullable
      - `targetAmount` string, nullable: The target amount for this ingredient such that this ingredient's proportion in its mixture would preserve the equivalent ingredient's proportion in the parent mixture. Pair with `units`.
      - `units` 'NL' | 'UL' | 'ML' | 'L' | 'MG' | 'G' | 'UNITS' | 'CELLS' | 'KG' | 'MOL' | 'UMOL' | 'MMOL' | 'UG'
    - `modifiedAt` string, datetime, nullable
    - `name` string, nullable: Name of the item.
    - `project` ProjectRef
      - `__typename` string
      - `id` string, api_id
    - `registrationOrigin` RegistrationOrigin: Captures the provenance of an entity's registration into the registry. The `originEntry` links to the `DocumentLike` (typically an entry or notebook) from which the entity was registered, providing traceability back to the original experimental context. The `registeredAt` timestamp records when the registration occurred. This information helps scientists understand where registered entities came from and when they were added to the registry.
      - `__typename` string
      - `originEntry` DocumentLikeRef
        - `__typename` string
        - `id` string, api_id
      - `registeredAt` string, datetime, nullable
    - `registry` RegistryRef
      - `__typename` string
      - `id` string, api_id
    - `schema` EntitySchemaRef
      - `__typename` string
      - `id` string, api_id
    - `typedSchema` MixtureSchemaRef
      - `__typename` string
      - `id` string, api_id
    - `units` 'NL' | 'UL' | 'ML' | 'L' | 'G' | 'KG' | 'UNITS' | 'UG' | 'MG'
    - `authors` string, uri, nullable
    - `creator` PrincipalRef
      - `__typename` string
      - `id` string, api_id
  - `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/3873a10bf7b8?raw)