> ## 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.

# API Updates 2024

> Gameball API updates, version changes, and migration guides for 2024.

<Update label="December 19, 2024" description="V4.0" tags={["API"]}>
  ## Gameball API V4.0 — A Major Upgrade

  We're thrilled to announce the release of **API V4.0** — our most powerful, efficient, and developer-friendly version yet!

  ***

  ### What's New

  #### **RESTful Architecture**

  V4 follows best-practice RESTful principles with cleaner, more predictable routes that make integration smoother and more intuitive.

  #### **Optimized Performance**

  Experience lightning-fast response times with streamlined request/response bodies that focus only on essential data.

  #### **Enhanced Security**

  New secured endpoints protect sensitive customer data with Secret Key authentication, ensuring PII remains safe.

  #### **Better Error Handling**

  Improved HTTP status codes and detailed error messages make debugging faster and easier.

  #### **New Endpoints**

  * Get Customer Activities — Track detailed engagement logs
  * Get All Customer Details (Secured) — Access full customer profiles safely
  * Get/Update Coupon Configurations — Manage discount settings with ease

  #### **Batch Processing (Beta)**

  Process thousands of operations in a single API call — transform how you manage large volumes of data.

  ***

  ### Breaking Changes

  <Note>
    **Player → Customer:** We've updated our terminology throughout the API. Update your integrations to use "Customer" instead of "Player."
  </Note>

  ***

  **Ready to upgrade?** Check out our [V4 API Documentation](/api-reference/introduction) and [What's New guide](/api-reference/overview/whats-new) for complete details on all the exciting changes.
</Update>