> ## Documentation Index
> Fetch the complete documentation index at: https://docs.defindex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Withdraw by burning specific amount of vault shares

> **User Experience Function**: Allows users to withdraw from a vault by specifying the exact number of vault shares to burn.



## OpenAPI

````yaml POST /vault/{address}/withdraw-shares
openapi: 3.0.0
info:
  title: DeFindex API
  description: API documentation for DeFindex endpoints
  version: 1.0.0
  contact: {}
  x-logo:
    url: https://links.paltalabs.io/defindex-full.svg
    backgroundColor: '#0e0e0e'
    altText: DeFindex Logo
    href: https://defindex.io
servers: []
security: []
tags: []
paths:
  /vault/{address}/withdraw-shares:
    post:
      tags:
        - Vault
      summary: Withdraw by burning specific amount of vault shares
      description: >-
        **User Experience Function**: Allows users to withdraw from a vault by
        specifying the exact number of vault shares to burn.
      operationId: VaultController_withdrawShares
      parameters:
        - name: address
          required: true
          in: path
          description: Stellar address of the vault contract
          schema:
            example: CBNKCU3HGFKHFOF7JTGXQCNKE3G3DXS5RDBQUKQMIIECYKXPIOUGB2S3
            type: string
        - name: network
          required: true
          in: query
          description: Stellar network to execute the transaction on (testnet or mainnet)
          schema:
            enum:
              - testnet
              - mainnet
            type: string
      requestBody:
        required: true
        description: 'Share withdrawal parameters. Optional: slippageBps (defaults to 0)'
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WithdrawSharesDto'
      responses:
        '400':
          description: Bad request - invalid parameters
        '403':
          description: Forbidden - caller is not authorized for this operation
components:
  schemas:
    WithdrawSharesDto:
      type: object
      properties:
        shares:
          type: number
          description: Amount of vault shares to withdraw. Must be a positive number.
          example: 1000000
          minimum: 0
        caller:
          type: string
          description: >-
            Stellar address of the user withdrawing shares. Must be a valid
            Stellar public key.
          example: GB7NTQG4EXB7NZEA5GNFHIHEQVTGQTZ6OWKWUD535FBEHNSEVCKZULIY
        slippageBps:
          type: number
          example: 100
          description: >-
            Slippage tolerance in basis points (bps). 10000 = 100%, 100 = 1%, 50
            = 0.5%. Default is 0 bps (0%)
          minimum: 0
          maximum: 10000
          default: 0
      required:
        - shares
        - caller

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.