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

# Balance Inquiry Batch Job

> Retrieve customer loyalty balances for multiple customers in a single API call for efficient balance management.

## Balance Inquiry Batch Job

Bulk balance inquiry processing for efficient customer balance management. This endpoint allows you to retrieve customer loyalty balances for multiple customers in a single batch operation.

<Info>
  **Security:** Requires **apiKey** and **secretKey** headers.
</Info>


## OpenAPI

````yaml POST /api/v4.0/integrations/batch/balance-inquiry
openapi: 3.1.0
info:
  title: Gameball API
  description: >-
    Gameball REST API v4.0 - Complete API reference for integrating loyalty,
    gamification, and customer engagement features
  version: 4.0.0
servers:
  - url: https://api.gameball.co
security:
  - bearerAuth: []
paths:
  /api/v4.0/integrations/batch/balance-inquiry:
    post:
      description: >-
        Retrieve customer loyalty balances for multiple customers in a single
        API call for efficient balance management.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                body:
                  type: array
                  items:
                    type: object
                    required:
                      - customerId
                    properties:
                      customerId:
                        type: string
                        description: Unique identifier for the customer.
      responses:
        '200':
          description: Batch balance inquiry processing initiated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  jobId:
                    type: number
                    description: >-
                      The assigned job ID, which is later used for status
                      verification and response retrieval.
      security:
        - apiKey: []
          secretKey: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKey:
      type: apiKey
      in: header
      name: apikey
    secretKey:
      type: apiKey
      in: header
      name: secretkey

````