List user streak logs

What this endpoint does

Lists streak log rows for the API key's community. Use it after current mini-game and streak state when you need history rather than the live counters.

It does not change streaks. It does not return wheel spin inventory. An unknown email is 404, not an empty list.

INFO

Workflow

Authenticate with getStreakLogs → GET /v1/streak-logs or ?user=<email> → read data.data and data.pagination → if the email is unknown, stop and look the member up.

Quick start

Omit user to read the community-scoped default page.

Authentication and permission

Send Authorization: Bearer <COMMUNITY_API_KEY>. Required permission: getStreakLogs (UI: Get Streak Logs). Keep the key server-side.

Complete examples

Default page (200). GET /v1/streak-logs with no query returns status: success and data.success: true, with data.data and pagination.

Existing member, no rows (200). ?user=<existing email> returns 200 with an empty data array when there is no history.

Unknown email (404). ?user=missing-user@example.com returns { "status": "error", "message": "User not found" }.

Treat emails as synthetic.

Success and readback

HTTP 200. Envelope is { status: "success", data: { success, pagination, data } }.

data.data is an array of log rows. Empty data with total: 0 means no rows matched, not that the route failed.

This is a read. Repeat the same request to refresh.

CHECK

Empty is not missing

A 200 with data: [] for a known email means this community has no streak-log rows for that member. Confirm the email with POST /v1/users/info before treating the member as unknown.

Errors and recovery

Status	When	Recovery
`404` `User not found`	`user` is a well-formed email that does not resolve in this community	Look up the member, then retry. Do not treat this as an empty history.
`401`	Missing or invalid Bearer token	Add a valid community key with `getStreakLogs`.

Retry safety

TIP

Exact retry

This GET does not write streak state. Retry timeouts and 500 with bounded backoff. Do not retry 404 User not found without changing user.

Gotchas

Unknown email → 404. Known email with no activity → 200 empty. Those are different.

Use this for streak history. Use /v1/users/mini-game-streak-stats for current spins and streak counters.

Next steps

Get current mini-game and streak state

Read live spin and streak counters for the same email.

curl --location --globoff 'https://sgtr-integration.returning.ai/apis/v1/streak-logs?user=undefined&streak_action=undefined&streak_name=undefined&streak_activity=undefined&date[gte]=undefined&date[lte]=undefined&time[gte]=undefined&time[lte]=undefined&sortBy=undefined&sortOrder=undefined&limit=undefined&page=undefined'

What this endpoint does

Quick start

Authentication and permission

Complete examples

Success and readback

Errors and recovery

Retry safety

Gotchas

Next steps

Request

Responses

List user streak logs

What this endpoint does#

Quick start#

Authentication and permission#

Complete examples#

Success and readback#

Errors and recovery#

Retry safety#

Gotchas#

Next steps#

Request

Responses

What this endpoint does

Quick start

Authentication and permission

Complete examples

Success and readback

Errors and recovery

Retry safety

Gotchas

Next steps