---
title: "Register contact lens box deliveries"
method: POST
path: "/api/public/v1/subscriptions/{subscription_id}/box_deliveries"
tags: ["Subscriptions"]
---

# Register contact lens box deliveries

`POST /api/public/v1/subscriptions/{subscription_id}/box_deliveries`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/public/v1/subscriptions/{subscription_id}/box_deliveries`
- Auth: HTTP basic

Records one or more contact lens box deliveries for a subscription. Each entry references a ContactLensSubscription cart item by its reference_uuid and the quantity of boxes delivered. Per-item box_count for the current subscription year is the cap.

## Path parameters

- `subscription_id` string, required

## Headers

- `Authorization` string, required

## Request body

- PublicCreateBoxDeliveryRequest
  - `deliveries` object[], required
    - `cart_item_reference_uuid` string, required
    - `quantity` integer, required

## Response `200`

two deliveries registered

- PublicCreateBoxDeliveryResponse
  - `deliveries` PublicSubscriptionMaterial[], required
    - `id` string, required
    - `reference` string, required
    - `reference_uuid` string, nullable
    - `type` string, required
    - `name` string, required
    - `quantity` integer, required
    - `price_with_tax` PrintableCurrency, required
      - `value` integer, required
      - `string` string, required
    - `total_with_tax` PrintableCurrency, required
      - `value` integer, required
      - `string` string, required
    - `subscription_price` PrintableCurrency
      - `value` integer, required
      - `string` string, required
    - `discount` object, nullable
      - `type` string
      - `amount` integer
    - `original_price_with_tax` PrintableCurrency
      - `value` integer, required
      - `string` string, required
    - `original_subscription_price` PrintableCurrency
      - `value` integer, required
      - `string` string, required
    - `price_without_mark_up` PrintableCurrency
      - `value` integer, required
      - `string` string, required
    - `catalogue_price_with_tax` PrintableCurrency
      - `value` integer, required
      - `string` string, required
    - `catalogue_subscription_price` PrintableCurrency
      - `value` integer, required
      - `string` string, required
    - `subscription_vat_rate` PrintablePercent
      - `value` number, required
      - `string` string, required
    - `subscription_price_net` PrintableCurrency
      - `value` integer, required
      - `string` string, required
    - `subscription_price_tax` PrintableCurrency
      - `value` integer, required
      - `string` string, required
    - `warranty_breakage_cost` PrintableCurrency
      - `value` integer, required
      - `string` string, required
    - `warranty_lost_cost` PrintableCurrency
      - `value` integer, required
      - `string` string, required
    - `cancellation_cost_kept` PrintableCurrency
      - `value` integer, required
      - `string` string, required
    - `cancellation_cost_returned` PrintableCurrency
      - `value` integer, required
      - `string` string, required
    - `activated_at` string, nullable
    - `added_at` string, nullable
    - `status` string, nullable
    - `product_data` object, nullable
    - `items` unknown[], nullable
      - unknown
    - `box_count` integer
    - `delivered_boxes` integer
    - `remaining_boxes` integer

## Other responses

- `400`: missing deliveries key
- `401`: unauthenticated
- `409`: no confirmed cart
- `422`: non-contact-lens cart item

---

[API](https://skmtc.dev/sequra/apis/instore-api.md) - [All operations](https://skmtc.dev/sequra/apis/instore-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sequra/apis/instore-api/revisions/29430b803abc?raw)