---
title: "POST /api/v1/receipt-items"
method: POST
path: "/api/v1/receipt-items"
tags: ["receipt-items"]
---

# POST /api/v1/receipt-items

`POST /api/v1/receipt-items`

## Request

- Base URL: `https://prices.openfoodfacts.org` (the document declares no server; this is the origin it was published from)
- URL: `https://prices.openfoodfacts.org/api/v1/receipt-items`
- Auth: HTTP bearer

## Request body

- ReceiptItemFull
  - `id` integer, required
  - `proof_id` integer, required
  - `price_id` integer, required
  - `order` integer, required: The order of the item in the receipt. Item on top is 1.
  - `predicted_data` unknown
  - `status` union: The current status of the item * `0` - deleted * `1` - linked_to_price
    - unknown
    - ''
    - unknown
  - `schema_version` string, nullable: The schema version of the predicted data. Used to handle changes in the prediction data structure.
  - `created` string, date-time: When the item was created in DB
  - `updated` string, date-time, required: When the item was last updated
  - `proof_prediction` integer, nullable: The proof prediction used to create this receipt item. Null if created by a user.

## Response `201`

- ReceiptItemFull
  - `id` integer, required
  - `proof_id` integer, required
  - `price_id` integer, required
  - `order` integer, required: The order of the item in the receipt. Item on top is 1.
  - `predicted_data` unknown
  - `status` union: The current status of the item * `0` - deleted * `1` - linked_to_price
    - unknown
    - ''
    - unknown
  - `schema_version` string, nullable: The schema version of the predicted data. Used to handle changes in the prediction data structure.
  - `created` string, date-time: When the item was created in DB
  - `updated` string, date-time, required: When the item was last updated
  - `proof_prediction` integer, nullable: The proof prediction used to create this receipt item. Null if created by a user.

## Changes

- **2026-07-13** `f1bb01adae9b`: 4 info
  - added the new optional request property `schema_version` (media type: application/json)
  - added the new optional request property `schema_version` (media type: application/x-www-form-urlencoded)
  - added the new optional request property `schema_version` (media type: multipart/form-data)
  - added the optional property `schema_version` to the response with the `201` status
- **2025-04-03** `f74128863f21`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openfoodfacts/apis/open-food-facts-open-prices-rest-api/changes/api/v1/receipt-items/post.md)

---

[API](https://skmtc.dev/openfoodfacts/apis/open-food-facts-open-prices-rest-api.md) - [All operations](https://skmtc.dev/openfoodfacts/apis/open-food-facts-open-prices-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openfoodfacts/apis/open-food-facts-open-prices-rest-api/revisions/d7c5d8b4c32e?raw)