---
title: "List a person's recipes"
method: GET
path: "/v1/locations/{locationId}/persons/{personId}/recipes"
tags: ["Recipes"]
---

# List a person's recipes

`GET /v1/locations/{locationId}/persons/{personId}/recipes`

## Request

- Base URL: `https://api.cliento.com`
- URL: `https://api.cliento.com/v1/locations/{locationId}/persons/{personId}/recipes`
- Auth: HTTP bearer

The person's recipes, newest first, one page at a time. The first one is what was mixed the last time.

## Path parameters

- `locationId` string, required
- `personId` string, required

## Query parameters

- `limit` integer
- `after` string

## Response `200`

OK

- RecipeList
  - `data` Recipe[], required
    - `appData` object: The JSON object of your own that is stored with the recipe, returned as it is.
    - `bowls` RecipeBowl[], required: The bowls mixed, in order.
      - `components` RecipeComponent[], required: What went into the bowl, 1 to 20.
        - `amount` string, required: How much, in `unit`, as a decimal string greater than 0 with at most three decimals.
        - `name` string, required: What it is, as the hairdresser reads it. At most 200 characters.
        - `productId` string: The product the component was taken from, when it is one of the location's.
        - `properties` object: Your own names and values for this component, at most 30. A name is at most 100 characters and a value at most 500.
        - `role` string: What the component is in the mix, as one lower-case word such as `colour` or `developer`. The list is open, so accept a value you do not know.
        - `shade` string: The shade code of a colour. At most 50 characters.
        - `strengthPercent` string: The strength of a developer in per cent, as a decimal string greater than 0 and at most 100, with at most two decimals.
        - `unit` string, required: The unit of `amount`, as the hairdresser reads it. At most 20 characters.
      - `properties` object: Your own names and values for this bowl, with the same limits as a component's `properties`.
      - `ratio` string: Parts of colour to parts of developer.
      - `title` string: What the bowl is for. At most 200 characters.
    - `createdAt` string, date-time, required
    - `id` string, required
    - `note` string
    - `personId` string, required
    - `properties` object
    - `stockReference` string
    - `title` string
    - `updatedAt` string, date-time: When staff last changed the recipe in Cliento. Left out when they never have.
  - `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)