---
title: "List Item Purchases"
method: GET
path: "/{databaseId}/items/{itemId}/purchases/"
tags: ["User-Item Interactions"]
---

# List Item Purchases

`GET /{databaseId}/items/{itemId}/purchases/`

Lists all the ever-made purchases of the given item.

## Path parameters

- `databaseId` string, required
- `itemId` string, required

## Response `200`

Successful operation.

- Purchase[]
  - `userId` string, required — User who purchased the item
  - `itemId` string, required — Purchased item
  - `timestamp` union — UTC timestamp of the purchase as ISO8601-1 pattern or UTC epoch time. The default value is the current time.
    - string, double
    - number, double
  - `cascadeCreate` boolean — Sets whether the given user/item should be created if not present in the database.
  - `amount` number, double — Amount (number) of purchased items. The default is 1. For example, if `user-x` purchases two `item-y` during a single order (session...), the `amount` should equal 2.
  - `price` number, double — Price paid by the user for the item. If `amount` is greater than 1, the sum of prices of all the items should be given.
  - `profit` number, double — Your profit from the purchased item. The profit is natural in the e-commerce domain (for example, if `user-x` purchases `item-y` for $100 and the gross margin is 30 %, then the profit is $30) but is also applicable in other domains (for example, at a news company it may be income from a displayed advertisement on article page). If `amount` is greater than 1, the sum of profit of all the items should be given.
  - `recommId` string — If this purchase is based on a recommendation request, `recommId` is the id of the clicked recommendation.
  - `additionalData` object — A dictionary of additional data for the interaction.

## Other responses

- `400` — The `itemId` does not match ^[a-zA-Z0-9_\-:@\.]+$.
- `404` — Given `itemId` not found in the database. If there is no additional info in the JSON response, you probably have an error in your URL.

---

[API](https://skmtc.dev/recombee/apis/recombee-api.md) · [All operations](https://skmtc.dev/recombee/apis/recombee-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recombee/recombee-api/revisions/a9c9c33eb2e8/schema)