---
title: "Get Customer Stamps Progress"
method: GET
path: "/api/v4.0/integrations/customers/{customerId}/stamps/{challengeId}"
---

# Get Customer Stamps Progress

`GET /api/v4.0/integrations/customers/{customerId}/stamps/{challengeId}`

## Request

- Base URL: `https://api.gameball.co`
- URL: `https://api.gameball.co/api/v4.0/integrations/customers/{customerId}/stamps/{challengeId}`
- Auth: API key in header `apikey` and API key in header `secretkey`

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.

## Path parameters

- `customerId` string, required
- `challengeId` integer, required

## Response `200`

Customer stamps progress found

- CustomerActionStreakProgressResponse
  - `numberOfCompletedSteps` number: The number of steps completed by the customer in the current challenge cycle
  - `numberOfTimesEarned` number: The total number of times the customer has successfully completed the challenge
  - `canAchieveAgain` boolean: Whether the customer is currently eligible to continue the challenge
  - `remainingTries` number: The number of remaining allowed completions within the current time interval
  - `challengeEndDate` string: The end date of the challenge in the client's local timezone
  - `rewardName` string: The name of the reward as defined in the client's configured language
  - `couponName` string: The name or value of the discount coupon assigned

## Changes

- **2026-01-04** `d41638533261`: 1 info
  - endpoint added
- **2025-09-02** `919eb7a392aa`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/gameballers/apis/gameball-api/changes/api/v4.0/integrations/customers/:customerId/stamps/:challengeId/get.md)

---

[API](https://skmtc.dev/gameballers/apis/gameball-api.md) · [All operations](https://skmtc.dev/gameballers/apis/gameball-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gameballers/apis/gameball-api/revisions/57b08ba96257?raw)