---
title: "Check out the cart"
method: POST
path: "/v1/buy/cart/checkout"
tags: ["Cart"]
---

# Check out the cart

`POST /v1/buy/cart/checkout`

## Request

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

Purchases the listed phone numbers from the cart. Activation and monthly fees are debited from the account balance immediately, and the purchase cannot be reversed through this API.

## Request body

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

## Response `201`

Returns a success confirmation. The phone numbers are purchased.

- SuccessResponse
  - `success` boolean, required: Indicates whether the request was successful.

## 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.
- `422`: Returns when the account balance cannot cover the cart total. The numbers that could not be purchased are listed in `error_dids`.

## Changes

- **2026-09-08** `6a89c962481c`: 1 breaking, 5 info
  - the response's body type changed from no type to `object` for status `201`
  - removed `#/components/schemas/SuccessResponse, subschema #2` from the response body `allOf` list for the response status `201`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - …2 more
- **2026-05-25** `33be77905120`: 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-04-20** `2e48fd9894e1`: 3 info
  - api operation id `CheckoutDIDnumbers` removed and replaced with `cart_checkout`
  - added `#/components/schemas/SuccessResponse` to the response body `allOf` list for the response status `201`
  - removed `#/components/schemas/OperationSuccessfulRepose` from the response body `allOf` list for the response status `201`
- **2026-02-12** `fabaadf195a9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v1/buy/cart/checkout/post.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)