---
title: "Add to cart"
method: PUT
path: "/v1/buy/cart"
tags: ["Cart"]
---

# Add to cart

`PUT /v1/buy/cart`

## Request

- Base URL: `https://api.wavix.com`
- URL: `https://api.wavix.com/v1/buy/cart`
- Auth: HTTP bearer

Adds the listed phone numbers to the purchase cart.

## Request body

- object
  - `ids` string[], required: Phone numbers to add to the cart.

## Response `200`

Returns the phone numbers now in the cart.

- AvailableNumber[]
  - `id` integer, required: Phone number ID.
  - `activation_fee` string, required: One-time activation fee in USD.
  - `monthly_fee` string, required: Monthly fee in USD.
  - `per_min` string, required: Price per inbound minute in USD.
  - `channels` string, int32, required: Maximum number of concurrent inbound calls.
  - `city` string, required: City where the phone number originates.
  - `country` string, required: Country where the phone number originates.
  - `country_short_name` string, required: Two-letter ISO country code.
  - `cnam` boolean, nullable, required: Indicates whether CNAM can be activated.
  - `free_min` integer, required: Number of free inbound minutes.
  - `number` string, required: Phone number in E.164 format.
  - `require_docs` DocumentType[], required: Documents to activate the number.
  - `sms_enabled` boolean, required: Indicates whether the phone number can receive inbound SMS and MMS messages.
  - `sms_price` number, float, required: Price per inbound SMS segment in USD.
  - `domestic_cli` boolean: Indicates whether the number can be used as the Caller ID for local calls.

## Other responses

- `400`: Request failed. Missing or invalid parameter <param_name>
- `401`: Unauthorized
- `403`: Request failed. The feature is disabled for your account.
- `404`: Request failed. An object with the specified ID is not found.

## Changes

- **2026-09-21** `76b9ec29392a`: 1 breaking, 3 warning
  - the `items/require_docs/items/` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `200`
  - added the new `address` enum value to the `items/require_docs/items/` response property for the response status `200`
  - added the new `id` enum value to the `items/require_docs/items/` response property for the response status `200`
  - added the new `localaddress` enum value to the `items/require_docs/items/` response property for the response status `200`
- **2026-09-08** `6a89c962481c`: 1 info
  - added the non-success response with the status `401`
- **2026-05-25** `33be77905120`: 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-04-20** `2e48fd9894e1`: 1 info
  - api operation id `AddDIDnumberstothecart` removed and replaced with `cart_add`
- **2026-02-12** `fabaadf195a9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v1/buy/cart/put.md)

---

[API](https://skmtc.dev/wavix/apis/wavix-apis.md) - [All operations](https://skmtc.dev/wavix/apis/wavix-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/wavix/apis/wavix-apis/revisions/f2dde79f05ab?raw)