> ## Documentation Index > Fetch the complete documentation index at: https://docs.wavix.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve the cart > Returns the current purchase cart, including the phone numbers it contains and the documents each requires. ## OpenAPI ````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml get /v1/buy/cart openapi: 3.1.0 info: title: Wavix APIs description: >- Wavix provides robust APIs that let you integrate voice and text messaging features directly into your app. Send text, place calls, and access detailed reports programmatically. termsOfService: https://wavix.com/terms-and-conditions license: name: MIT identifier: MIT contact: name: Wavix url: https://wavix.com email: support@wavix.com version: 1.1.1 servers: - url: https://api.wavix.com description: https://api.wavix.com variables: {} security: - bearerAuth: [] tags: - name: SIP trunks description: SIP trunks - name: Buy description: Numbers - name: Cart description: Numbers - name: My numbers description: Numbers - name: Billing description: Billing, transactions, and invoices - name: Profile description: Account profile and customer information - name: CDRs description: Call detail records and call history - name: Speech Analytics description: Call transcription and speech analytics - name: SMS and MMS description: Messaging - name: Number Validator description: Phone number validation - name: Link shortener description: Short link and click metrics - name: 2FA description: Two-factor authentication - name: 10DLC description: 10DLC Campaigns and Brands - name: API Keys description: API key management - name: Call webhooks description: Webhook configuration for call events - name: Call control description: Programmable Voice - name: Call streaming description: Real-time call audio streaming over WebSocket - name: Call recording description: Call recording - name: Sub-accounts description: Sub-account management - name: Voice campaigns description: Outbound voice campaigns - name: Wavix Embeddable description: WebRTC embeddable widget - name: WhatsApp description: WhatsApp senders, templates, and messages paths: /v1/buy/cart: get: tags: - Cart summary: Retrieve the cart description: >- Returns the current purchase cart, including the phone numbers it contains and the documents each requires. operationId: cart_get parameters: [] responses: '200': description: Returns the cart. headers: {} content: application/json: schema: $ref: '#/components/schemas/CartResponse' examples: default: value: dids: - activation_fee: '15.0' channels: '4' city: Buenos Aires cnam: false country: Argentina country_short_name: AR domestic_cli: false free_min: 0 id: 541139862174 monthly_fee: '10.0' number: '541139862174' per_min: '0.01' require_docs: [] sms_enabled: false sms_price: 0 doc_types: - id: 1 name: id title: Any form of ID - id: 2 name: address title: Proof of address - id: 3 name: localaddress title: Proof of local address '401': $ref: '#/components/responses/UnauthorizedErrorResponse' '403': $ref: '#/components/responses/ForbiddenErrorResponse' deprecated: false security: - bearerAuth: - numbers:read components: schemas: CartResponse: title: CartResponse required: - dids - doc_types type: object additionalProperties: false properties: dids: type: array description: List of phone numbers in the cart. items: $ref: '#/components/schemas/AvailableNumber' doc_types: type: array items: $ref: '#/components/schemas/DocumentTypeInfo' description: Document types required to activate phone numbers. AvailableNumber: title: AvailableNumber required: - id - activation_fee - monthly_fee - per_min - channels - city - country - country_short_name - cnam - free_min - number - require_docs - sms_enabled - sms_price type: object additionalProperties: false properties: id: type: integer description: Phone number ID. format: int64 example: 541139862174 activation_fee: type: string description: One-time activation fee in USD. example: '15.0' monthly_fee: type: string description: Monthly fee in USD. example: '10.0' per_min: type: string description: Price per inbound minute in USD. example: '0.01' channels: type: string description: Maximum number of concurrent inbound calls. format: int32 example: '4' city: type: string description: City where the phone number originates. example: Buenos Aires country: type: string description: Country where the phone number originates. example: Argentina country_short_name: type: string description: Two-letter ISO country code. example: AR cnam: type: - boolean - 'null' description: Indicates whether CNAM can be activated. example: false free_min: type: integer description: Number of free inbound minutes. format: int32 example: 0 number: type: string description: Phone number in E.164 format. example: '541139862174' require_docs: type: array items: $ref: '#/components/schemas/DocumentType' description: Documents to activate the number. example: - address sms_enabled: type: boolean description: |- Indicates whether the phone number can receive inbound SMS and MMS messages. example: false sms_price: type: number format: float description: Price per inbound SMS segment in USD. example: 0 domestic_cli: type: boolean description: >- Indicates whether the number can be used as the Caller ID for local calls. example: true description: Phone number available for purchase. DocumentTypeInfo: title: DocumentTypeInfo description: Document type required to activate a phone number. required: - id - name - title type: object additionalProperties: false properties: id: type: integer format: int32 description: Document type ID. example: 2 name: $ref: '#/components/schemas/DocumentType' title: type: string description: Document type name. example: Proof of address UnauthorizedErrorResponse: title: UnauthorizedErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false error: type: boolean description: >- Indicates that the response represents an error. Always `true` for this error. example: true message: type: string description: >- Human-readable description stating that authentication is missing or invalid. example: Unauthorized ForbiddenErrorResponse: title: ForbiddenErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: Human-readable description of why access is forbidden. example: The service is not provisioned for your account. DocumentType: title: DocumentType type: string description: >- 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. enum: - id - address - localaddress responses: UnauthorizedErrorResponse: description: Unauthorized headers: {} content: application/json: schema: $ref: '#/components/schemas/UnauthorizedErrorResponse' ForbiddenErrorResponse: description: Request failed. The feature is disabled for your account. headers: {} content: application/json: schema: $ref: '#/components/schemas/ForbiddenErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer description: > Wavix API key. Pass as `Authorization: Bearer `. Keys support per-resource scopes (none / read / write). See [Restricted keys and scopes](https://docs.wavix.com/api-reference/authentication#restricted-keys-and-scopes). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.