Read the authenticated account Points summary and streak.
GET /api/v1/me/points. Read the authenticated account Points summary and streak.
Request
GET /api/v1/me/points
Authentication is required. Supported credentials: a signed-in customer session token in Authorization: Bearer …. This route does not accept customer API keys.
Parameters
| Name | In | Type | Required | Constraints | Description |
|---|---|---|---|---|---|
X-Service-Act-As | header | string | No | min length: 3; max length: 512 | Service-principal path only (local and devnet stages; refused by configuration on mainnet). With an OAuth client-credentials bearer token from the validator, names the allow-listed Party the client acts as. Missing: 400 SERVICE_ACT_AS_REQUIRED; not allow-listed: 403 SERVICE_PARTY_NOT_ALLOWED. Ignored for customer session tokens. |
X-Request-Id | header | string | No | min length: 8; max length: 128; pattern: ^[A-Za-z0-9._:-]+$ | Optional client correlation identifier. The server always generates a separate authoritative request ID and retains a valid supplied value only as secondary audit correlation metadata. |
cURL
curl --fail-with-body --silent --show-error \
--request GET \
--url "https://launch-api.supanova.app/api/v1/me/points" \
--header "Authorization: Bearer $SUPANOVA_SESSION_TOKEN"Responses
200
Account-owned Points preview summary.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
balance | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})$ | — |
daily | object · Schema 1 | Yes | — | — |
leaderboardRanks | object · Schema 2 | Yes | — | — |
meta | object · Schema 3 | Yes | — | — |
progress | object · Schema 4 | Yes | — | — |
streak | object · Schema 5 | Yes | — | — |
totals | object · Schema 6 | Yes | — | — |
Additional fields are not allowed.
400
The request is malformed or failed validation. Codes: AMBIGUOUS_CREDENTIALS, SERVICE_ACT_AS_REQUIRED.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
401
Credentials are missing, malformed, expired or revoked. Codes: AUTHENTICATION_REQUIRED, INVALID_AUTHORIZATION_HEADER, INVALID_ACCESS_TOKEN, SESSION_REVOKED.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
403
The credential may not call this route. Codes: ACCOUNT_RESTRICTED, ANONYMOUS_ACCOUNT_NOT_ALLOWED, API_KEY_ROUTE_NOT_ALLOWED, SERVICE_PARTY_NOT_ALLOWED, SERVICE_PRINCIPAL_NOT_ALLOWED, SIGNUP_NOT_INVITED.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
429
The caller exceeded an IP or principal request budget.
| Header | Type | Description |
|---|---|---|
Retry-After | integer | Whole seconds to wait before retrying a rate-limited request. |
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
503
A durable, reviewed Supanova Points policy engine is not configured. Also: AUTHENTICATION_UNAVAILABLE, AUTHORIZATION_UNAVAILABLE.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
default
Machine-readable API error. The HTTP status identifies the error class.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
Nested schemas
Field links above lead to the complete nested object, array, and variant definitions below. Required fields are scoped to their containing object.
Schema 1
Response 200.daily
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
availablePoints | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})$ | — |
completedTaskCount | integer | Yes | minimum: 0; maximum: 3 | — |
date | string | Yes | pattern: ^\d{4}-\d{2}-\d{2}$ | — |
resetAt | string | Yes | format: date-time; pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | — |
taskCount | 3 | Yes | — | — |
tasks | array of object · Schema 7 | Yes | min items: 3; max items: 3 | — |
Additional fields are not allowed.
Schema 2
Response 200.leaderboardRanks
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
all | one or more variants · Schema 8 | Yes | — | — |
week | one or more variants · Schema 8 | Yes | — | — |
Additional fields are not allowed.
Schema 3
Response 200.meta
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
asOf | string | Yes | format: date-time; pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | — |
authority | "supanova-product" | Yes | — | — |
dataMode | "simulated" | Yes | — | — |
disclaimer | string | Yes | min length: 1; max length: 1024 | — |
ledgerEffect | "none" | Yes | — | — |
policyVersion | "points-preview-2026-08-07.1" | Yes | — | — |
Additional fields are not allowed.
Schema 4
Response 200.progress
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
activeWeeks | integer | Yes | minimum: 0; maximum: 9007199254740991 | — |
currentTier | object · Schema 9 | Yes | — | — |
highestTierQualificationMet | boolean | Yes | — | — |
nextTier | one or more variants · Schema 10 | Yes | — | — |
pointsToNextTier | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})$ | — |
Additional fields are not allowed.
Schema 5
Response 200.streak
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
bestDays | integer | Yes | minimum: 0; maximum: 9007199254740991 | — |
completionRatePercent | integer | Yes | minimum: 0; maximum: 100 | — |
currentDays | integer | Yes | minimum: 0; maximum: 9007199254740991 | — |
recentDays | array of object · Schema 11 | Yes | max items: 31 | — |
Additional fields are not allowed.
Schema 6
Response 200.totals
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
qualifiedReferrals | integer | Yes | minimum: 0; maximum: 9007199254740991 | — |
referralPoints | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})$ | — |
tasksCompleted | integer | Yes | minimum: 0; maximum: 9007199254740991 | — |
Additional fields are not allowed.
Schema 7
Response 200.daily.tasks
Type: array of object.
min items: 3; max items: 3
Array items: object · Schema 12.
Schema 8
Response 200.leaderboardRanks.all
Type: one or more variants.
At least one of these variants must match:
- Variant 1: integer. maximum:
9007199254740991; greater than:0 - Variant 2: null.
Schema 9
Response 200.progress.currentTier
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
description | string | Yes | min length: 1; max length: 500 | — |
id | string | Yes | allowed: "stargazer", "pathfinder", "voyager", "luminary", "nova_prime" | — |
minimumActiveWeeks | integer | Yes | minimum: 0; maximum: 52 | — |
minimumPoints | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})$ | — |
name | string | Yes | allowed: "Stargazer", "Pathfinder", "Voyager", "Luminary", "Nova Prime" | — |
Additional fields are not allowed.
Schema 10
Response 200.progress.nextTier
Type: one or more variants.
At least one of these variants must match:
- Variant 1: object · Schema 9.
- Variant 2: null.
Schema 11
Response 200.streak.recentDays
Type: array of object.
max items: 31
Array items: object · Schema 13.
Schema 12
Response 200.daily.tasks item
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
awardPoints | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})$ | — |
awardedPoints | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})$ | — |
id | string | Yes | allowed: "daily_transaction", "daily_swap", "daily_referral" | — |
status | string | Yes | allowed: "available", "completed" | — |
Additional fields are not allowed.
Schema 13
Response 200.streak.recentDays item
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
completedTaskCount | integer | Yes | minimum: 0; maximum: 3 | — |
date | string | Yes | pattern: ^\d{4}-\d{2}-\d{2}$ | — |
status | string | Yes | allowed: "complete", "partial", "empty" | — |
Additional fields are not allowed.
Source contract
This page is generated from the checked-in customer OpenAPI snapshot. Download JSON, download YAML, or compare the live API reference. Snapshot provenance records the retrieval date and checksum.