---
title: "List colour bar mixes"
method: GET
path: "/v1/locations/{locationId}/colour-bar-mixes"
tags: ["Colour bar mixes"]
---

# List colour bar mixes

`GET /v1/locations/{locationId}/colour-bar-mixes`

## Request

- Base URL: `https://api.cliento.com`
- URL: `https://api.cliento.com/v1/locations/{locationId}/colour-bar-mixes`
- Auth: HTTP bearer

The location's mixes, newest first, one page at a time, including those that were undone. With `staffId`, one staff member's. With `externalReference`, the mix registered under that reference, if there is one; it is sent without `staffId` and `after`.

## Path parameters

- `locationId` string, required

## Query parameters

- `limit` integer
- `after` string
- `staffId` string
- `externalReference` string

## Response `200`

OK

- ColourBarMixList
  - `data` ColourBarMix[], required
    - `bowls` ColourBarMixBowl[], required
      - `components` ColourBarMixComponent[], required
        - `amount` integer, required: How much was taken: grams, or whole packs of an item that has no pack size.
        - `colourBarItemId` string, required
        - `fromFinishedPack` integer: The grams of `amount` that came out of the finished pack before it ran out, when a new pack was opened midway.
        - `listValue` string: What `amount` was worth at the list price then, VAT excluded, as a decimal string with up to four decimals. Left out when the item had no list price.
        - `name` string, required: What the item was called when the mix was registered.
        - `openUsed` integer, required: The item's `openUsed` after this component.
        - `openedNewPack` boolean, required: Whether a new pack was opened for this component.
        - `packs` integer, required: The item's `packs` after this component.
        - `packsFinished` integer, required: The packs this component finished, which is what it took from stock.
        - `residue` integer: Set only when `openedNewPack` is `true`: the pack size less the grams that had been taken from the finished pack.
        - `shade` string: The item's shade when the mix was registered.
      - `ratio` string: Colour to developer, as it was sent. Kept as it is.
      - `title` string
    - `createdAt` string, date-time, required
    - `externalReference` string: Your own id for the mix.
    - `id` string, required: Colour bar mix id.
    - `listValue` string, required: What the mix took, at the list prices then, VAT excluded: its components' `listValue` together, rounded to two decimals, as a decimal string in the location's currency.
    - `locationId` string, required
    - `note` string
    - `recipeId` string: The recipe the mix was saved as on a person, when it was.
    - `registeredBy` string: The name of who mixed: the staff member, or the API key when none was named.
    - `staffId` string: The staff member who mixed. Left out when none was named.
    - `title` string
    - `undoneAt` string, date-time: When the mix was undone. Left out for a mix that stands.
    - `undoneBy` string: The name of who undid the mix.
    - `updatedAt` string, date-time, required: When the mix last changed: when it was undone, otherwise `createdAt`.
  - `nextCursor` string: Pass as `after` to fetch the next page. Absent on the last page.

## Other responses

- `default`: Any failure. See the Errors section.

---

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