---
title: "Retrieve the cart"
method: GET
path: "/v1/buy/cart"
tags: ["Cart"]
---

# Retrieve the cart

`GET /v1/buy/cart`

## Request

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

Returns the current purchase cart, including the phone numbers it contains and the documents each requires.

## Response `200`

Returns the cart.

- CartResponse
  - `dids` AvailableNumber[], required: List of phone numbers in the cart.
    - `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.
  - `doc_types` DocumentTypeInfo[], required: Document types required to activate phone numbers.
    - `id` integer, required: Document type ID.
    - `name` 'id' | 'address' | 'localaddress', required: Document type required to activate a phone number. One of: `id` - any form of ID, `address` - proof of address, `localaddress` - proof of local address within the country.
    - `title` string, required: Document type name.

## Other responses

- `401`: Unauthorized
- `403`: Request failed. The feature is disabled for your account.

## Changes

- **2026-09-21** `76b9ec29392a`: 1 breaking, 6 warning
  - the `dids/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 `dids/items/require_docs/items/` response property for the response status `200`
  - added the new `address` enum value to the `doc_types/items/name` response property for the response status `200`
  - added the new `id` enum value to the `dids/items/require_docs/items/` response property for the response status `200`
  - …3 more
- **2026-09-08** `6a89c962481c`: 1 breaking, 5 info
  - the response's body type changed from no type to `object` for status `200`
  - removed `#/components/schemas/CartResponse, subschema #2` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `401`
  - removed the non-success response with the status `400`
  - …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 `Getcartcontent` removed and replaced with `cart_get`
  - added `#/components/schemas/CartResponse` to the response body `allOf` list for the response status `200`
  - removed `#/components/schemas/BuyCartResponse` from the response body `allOf` list for the response status `200`
- **2026-02-12** `fabaadf195a9`: 1 info
  - endpoint added

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