> ## 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 Adjustment Batch Job

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

## Balance Adjustment Batch Job

Bulk balance adjustments for efficient customer balance management. This endpoint allows you to adjust 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-adjustment
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-adjustment:
    post:
      description: >-
        Adjust 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
                      - amount
                    properties:
                      customerId:
                        type: string
                        description: Unique identifier for the customer.
                      amount:
                        type: number
                        description: Amount to adjust the balance by.
                      reason:
                        type: string
                        description: Reason for the balance adjustment.
      responses:
        '200':
          description: Batch balance adjustment 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

````