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

# Customer Stamps Progress

> Retrieve the progress of a specific customer within a particular Stamps campaign in Gameball.

This API retrieves the progress of a specific customer within a particular Stamps campaign in Gameball. It returns how many steps the customer has completed, how many times they've earned the campaign reward, and whether they are eligible to continue.

<Info>
  **Security**: Requires **apikey** and **secretkey** headers.
</Info>


## OpenAPI

````yaml GET /api/v4.0/integrations/customers/{customerId}/stamps/{challengeId}
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/customers/{customerId}/stamps/{challengeId}:
    get:
      summary: Get Customer Stamps Progress
      description: >-
        Retrieve the progress of a specific customer within a particular Stamps
        campaign in Gameball. It returns how many steps the customer has
        completed, how many times they've earned the campaign reward, and
        whether they are eligible to continue.
      operationId: getCustomerStampsProgress
      parameters:
        - name: customerId
          in: path
          required: true
          description: >-
            Unique identifier for the customer that you can reference across the
            customer's whole lifetime. Could be a database ID, random string,
            email, or anything that uniquely identifies the customer.
          schema:
            type: string
        - name: challengeId
          in: path
          required: true
          schema:
            type: integer
          description: Unique identifier of the Stamps campaign to retrieve progress for.
      responses:
        '200':
          description: Customer stamps progress found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerActionStreakProgressResponse'
      security:
        - apiKey: []
          secretKey: []
components:
  schemas:
    CustomerActionStreakProgressResponse:
      type: object
      properties:
        numberOfCompletedSteps:
          type: number
          description: >-
            The number of steps completed by the customer in the current
            challenge cycle
        numberOfTimesEarned:
          type: number
          description: >-
            The total number of times the customer has successfully completed
            the challenge
        canAchieveAgain:
          type: boolean
          description: Whether the customer is currently eligible to continue the challenge
        remainingTries:
          type: number
          description: >-
            The number of remaining allowed completions within the current time
            interval
        challengeEndDate:
          type: string
          description: The end date of the challenge in the client's local timezone
        rewardName:
          type: string
          description: >-
            The name of the reward as defined in the client's configured
            language
        couponName:
          type: string
          description: The name or value of the discount coupon assigned
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKey:
      type: apiKey
      in: header
      name: apikey
    secretKey:
      type: apiKey
      in: header
      name: secretkey

````