---
title: "Get a colour bar range"
method: GET
path: "/v1/locations/{locationId}/colour-bar-ranges/{colourBarRangeId}"
tags: ["Colour bar ranges"]
---

# Get a colour bar range

`GET /v1/locations/{locationId}/colour-bar-ranges/{colourBarRangeId}`

## Request

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

## Path parameters

- `locationId` string, required
- `colourBarRangeId` string, required

## Response `200`

OK

- ColourBarRange: Represents a supplier's series as a location keeps it at its colour bar, such as one brand's permanent colours. Belongs to a location. Holds what its items have in common: their kind, the size of a pack and its list price. Colour bar items belong to it.
  - `brand` string
  - `createdAt` string, date-time, required
  - `id` string, required: Colour bar range id.
  - `kind` string, required: What the range's items are used as, such as `colour` or `developer`. A lower-case word; the list is open.
  - `listPrice` string: The supplier's list price of one pack, VAT excluded, as a decimal string in the location's currency.
  - `locationId` string, required
  - `name` string, required: What the range is called at the location.
  - `packSize` integer: Grams in one pack of the range's items. Left out for a range whose items are used a whole pack at a time.
  - `series` string: The supplier's name of the series.
  - `updatedAt` string, date-time, required: When the range itself was last changed.

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