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

# Gift Card Balance

> Retrieves details of a gift card based on the gift card name provided. The response includes the starting balance, ending balance, and currency. 
Returns an error message if the gift card is not found or has an empty balance.




## OpenAPI

````yaml POST /cart/getGift
openapi: 3.0.0
info:
  title: MineStoreCMS REST API
  description: Documentation for MineStoreCMS Frontend REST API.
  version: 3.8.7
servers:
  - url: https://v3.minestorecms.com/api
    description: Example URL of Demo Server
security: []
tags: []
paths:
  /cart/getGift:
    post:
      tags:
        - cart
      summary: Retrieve details of a gift card
      description: >
        Retrieves details of a gift card based on the gift card name provided.
        The response includes the starting balance, ending balance, and
        currency. 

        Returns an error message if the gift card is not found or has an empty
        balance.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                gift:
                  type: string
                  description: The name of the gift card to retrieve.
                  example: Summer2024
              required:
                - gift
      responses:
        '200':
          description: Successfully retrieved gift card details or error message
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      status:
                        type: boolean
                        description: Status of the request.
                        example: true
                      start_balance:
                        type: number
                        format: float
                        description: Starting balance of the gift card.
                        example: 100
                      end_balance:
                        type: number
                        format: float
                        description: Ending balance of the gift card.
                        example: 75
                      currency:
                        type: string
                        description: Currency of the gift card balance.
                        example: USD
                    required:
                      - status
                      - start_balance
                      - end_balance
                      - currency
                  - type: object
                    properties:
                      status:
                        type: boolean
                        description: Status of the request.
                        example: false
                      message:
                        type: string
                        description: >-
                          Error message if the gift card is not found or has an
                          empty balance.
                        example: Gift card not found!
                    required:
                      - status
                      - message
        '401':
          description: Unauthorized access, invalid or missing access token
      deprecated: false

````