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

# Get a colour bar mix

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

## Request

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

## Path parameters

- `locationId` string, required
- `colourBarMixId` string, required

## Response `200`

OK

- ColourBarMix: Represents what one staff member mixed at a location's colour bar at one time: one or more bowls, each with the colour bar items it took from and how much of each. Belongs to a location. Registering it changes the items it names: what was taken is added to an item's `openUsed`, and a pack is taken from stock when one is finished. A mix is not changed afterwards; it can be undone.
  - `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`.

## 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)