Skip to main content
Returns the points, rank, number of participants and blacklist status for a wallet across all point systems accessible to the API key. Accepts a 0x address or an ENS name — resolution is automatic.

​
GET /api/points

​
Request

GET https://api.rewards.so/api/points?address=vitalik.eth
Authorization: Bearer rw_your_api_key

​
Query parameters

ParameterTypeRequiredDescription
addressstringYes0x address or ENS name (e.g. vitalik.eth)

​
Response 200

{
  "address": "vitalik.eth",
  "ens": "vitalik.eth",
  "hexAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "resolvedAt": "2026-04-18T12:00:00.000Z",
  "pointSystems": [
    {
      "id": "e3b0c442-98fc-1c14-9afb-ed5a7b8c6f21",
      "name": "My Loyalty Program",
      "slug": "my-loyalty",
      "points": 1500,
      "events": 12,
      "rank": 3,
      "totalParticipants": 250,
      "isBlacklisted": false,
      "blacklistReason": null,
      "blacklistedAt": null
    }
  ],
  "summary": {
    "totalPointSystems": 1,
    "totalPoints": 1500,
    "blacklistedCount": 0,
    "isBlacklisted": false
  }
}

​
Response fields

​
Root

FieldTypeDescription
addressstringDisplay address (ENS if resolved, otherwise 0x)
ensstring | nullENS name if resolved, otherwise null
hexAddressstringLowercase 0x address
resolvedAtstringISO timestamp of the resolution
pointSystemsarrayPer-point-system breakdown
summaryobjectGlobal aggregate

​
pointSystems[]

FieldTypeDescription
idstringPoint system UUID
namestringPoint system name
slugstring | nullPublic leaderboard slug
pointsnumberTotal points accumulated
eventsnumberNumber of point events
ranknumber | nullRank in this point system (null if blacklisted with no wallet entry)
totalParticipantsnumber | nullTotal number of wallets in this point system
isBlacklistedbooleanWhether the wallet is blacklisted
blacklistReasonstring | nullReason for the blacklist
blacklistedAtstring | nullISO timestamp of the blacklist

​
summary

FieldTypeDescription
totalPointSystemsnumberNumber of point systems the wallet appears in
totalPointsnumberTotal points across all point systems
blacklistedCountnumberNumber of point systems where the wallet is blacklisted
isBlacklistedbooleantrue if blacklisted in at least one point system

​
Errors

StatusMessageCause
400Missing required parameter: addressMissing address query parameter
400Invalid address or ENS domainUnrecognized format
401Missing API keyNo Authorization header
401Invalid API keyKey not found
403This API key does not have read permissionsKey lacks read permission

​
Edge cases

Pre-emptive blacklist — if a wallet was blacklisted before receiving any points, it still appears in pointSystems with points: 0 and rank: null. Unknown wallet — if the wallet does not appear in any point system, pointSystems will be empty and summary.totalPointSystems will be 0.

​
Code examples

curl "https://api.rewards.so/api/points?address=vitalik.eth" \
  -H "Authorization: Bearer rw_your_api_key"