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

> Get the current state of vesting assets for a beneficiary including locked amounts and release schedule.

# State of vesting assets



## OpenAPI

````yaml cardano/managed-contracts-api/openapi.json get /contracts/vesting/state/{beneficiary}
openapi: 3.0.3
info:
  title: Cardano - Managed Contracts API
  description: https://docs.gomaestro.org/getting-started
  contact:
    name: Maestro
    email: info@gomaestro.org
    url: https://gomaestro.org/
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.txt
  version: v1.9.0
servers:
  - url: https://mainnet.gomaestro-api.org/v1
    description: Cardano Mainnet
  - url: https://preprod.gomaestro-api.org/v1
    description: Cardano Preprod
  - url: https://preview.gomaestro-api.org/v1
    description: Cardano Preview
security:
  - api-key: []
paths:
  /contracts/vesting/state/{beneficiary}:
    get:
      tags:
        - Vesting
      summary: State of vesting assets
      description: Detailed list of vesting assets at a beneficiary address
      operationId: vesting_state
      parameters:
        - name: beneficiary
          in: path
          description: Beneficiary bech32 address
          required: true
          schema:
            type: string
      responses:
        '200':
          description: List of vesting assets successfully returned
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VestingState'
        '400':
          description: Bad Request. Invalid beneficiary address.
components:
  schemas:
    VestingState:
      type: object
      description: Vesting states at a beneficiary address
      required:
        - asset_name
        - asset_symbol
        - total_installments
        - total_vesting_quantity
        - vesting_period_start
        - vesting_period_end
      properties:
        asset_name:
          type: string
          description: Asset policy token name of the asset to be locked
        asset_symbol:
          type: string
          description: Asset policy token symbol of the asset to be locked
        remaining_vesting_quantity:
          type: integer
          description: Remaning amount of the token left to vest
        total_installments:
          type: integer
          description: Number of vesting installments used to collect vested assets
        total_vesting_quantity:
          type: integer
          description: Total amount of the asset that will be vested
        vesting_period_start:
          type: integer
          description: Vesting period start in UNIX time (seconds)
        vesting_period_end:
          type: integer
          description: Vesting period end in UNIX time (seconds)
      example:
        asset_name: 564152444f
        asset_symbol: 6b0ffe54a4d0393ee7d4eb423ed933cf2dddbb0d05bc24237fd0f16a
        remaining_vesting_quantity: '0'
        total_installments: '1'
        total_vesting_quantity: '950000'
        vesting_period_start: '1692664993000'
        vesting_period_end: '1692664998000'
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: api-key
      description: Project API Key

````