Colour bar mixes

Get a colour bar mix by id

The same colour bar mix as under its location, found from its id. For a caller that holds an id and not the location it belongs to, such as one read from a stock movement. The answer carries locationId.

get/v1/colour-bar-mixes/{colourBarMixId}

Request

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

Path parameters

colourBarMixIdstring required

Response

OK

createdAtstring date-time required
externalReferencestring

Your own id for the mix.

idstring required

Colour bar mix id.

listValuestring 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.

locationIdstring required
notestring
recipeIdstring

The recipe the mix was saved as on a person, when it was.

registeredBystring

The name of who mixed: the staff member, or the API key when none was named.

staffIdstring

The staff member who mixed. Left out when none was named.

titlestring
undoneAtstring date-time

When the mix was undone. Left out for a mix that stands.

undoneBystring

The name of who undid the mix.

updatedAtstring date-time required

When the mix last changed: when it was undone, otherwise createdAt.

Example response

{
  "bowls": [
    {
      "components": [
        {
          "amount": 30,
          "colourBarItemId": "cbi_3Vn8Kq5TzL1xWc7PdM2RbJ",
          "fromFinishedPack": 12,
          "listValue": "68.5000",
          "name": "7/10",
          "openUsed": 30,
          "packs": 4,
          "residue": 3,
          "shade": "7/10"
        }
      ],
      "ratio": "1:1",
      "title": "Roots"
    }
  ],
  "createdAt": "2026-10-12T08:15:30Z",
  "externalReference": "mix-2026-10-12-0042",
  "id": "cbm_8Wq3Nd6HtY1mKx4LcP9RvB",
  "listValue": "91.33",
  "locationId": "loc_4fK9xQ2mLr8TzB1vNc7HdW",
  "note": "35 min",
  "recipeId": "rcp_6Jn2Xw8QdT5bVh3ZmK7LsF",
  "registeredBy": "Anna",
  "staffId": "stf_2Hs7Bq4MnX9cLk1VtR6PzD",
  "title": "Roots and lengths",
  "undoneAt": "2026-10-12T09:02:11Z",
  "undoneBy": "Anna",
  "updatedAt": "2026-10-12T08:15:30Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.