---
title: "Get Customer Daily Streak Progress"
method: GET
path: "/api/v4.0/integrations/customers/{customerId}/streaks/{campaignId}"
---

# Get Customer Daily Streak Progress

`GET /api/v4.0/integrations/customers/{customerId}/streaks/{campaignId}`

## Request

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

Retrieve the progress of a specific customer within a particular daily streak campaign in Gameball. It returns the current and highest streak counts, ongoing reward details, badge milestones, and the next milestone to unlock.

## Path parameters

- `customerId` string, required
- `campaignId` integer, required

## Response `200`

Customer daily streak progress found

- CustomerDailyStreakProgressResponse
  - `currentStreakCount` number: Number of consecutive periods completed in the current active streak
  - `highestStreakCount` number: Highest streak count ever reached by this customer for this campaign
  - `totalRewardsEarned` number: Total streak rewards earned across all time
  - `ongoingReward` object: Details of the currently active reward tier
    - `name` string: Reward name as configured in the client language settings
    - `type` string: Reward type: points or coupon
    - `value` string: Reward value (points amount or coupon description)
  - `nextMilestone` number, nullable: Streak count at which the next reward unlocks, or null if at the last tier
  - `lastActivityDate` string, date-time: Date/time of the last qualifying action in the client's local timezone
  - `campaignEndDate` string, date-time, nullable: Campaign end date in the client's local timezone, or null if open-ended
  - `badges` object[]: Badge milestones ordered by milestoneDay ascending
    - `milestoneDay` number: Streak day at which this badge is awarded
    - `name` string: Badge name
    - `imageUrl` string: Badge image URL
    - `earned` boolean: Whether this customer has earned this badge
    - `earnedDate` string, date-time, nullable: Date earned, or null if not yet earned

## Other responses

- `401`: Unauthorized – apikey or secretkey is missing or invalid
- `404`: Customer or campaign not found

## Changes

- **2026-03-18** `c31fbaf8e084`: 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/streaks/:campaignId/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)