Skip to content
SteamSets
Esc
↑↓navigate↵open⌘Jpreview

Get this month's donation goal progress

Public — no auth required. Aggregated per calendar month (UTC). Carries no per-donor amounts.

POST/v1/donate.getGoal
Authorization
AuthorizationBearer token · headerrequired
Responses
200

OK

anonymousCountinteger<int32>required

Donations this month with no resolvable account

min 0
goalCentsinteger<int32>required

Configured monthly goal in cents

min 0
monthstringrequired

Current calendar month, UTC

raisedCentsinteger<int32>required

Sum of donation ledger rows this month, in cents

min 0
supporterCountinteger<int32>required

Distinct accounts plus anonymous donations this month

min 0
supportersDonateSupporter[] | nullrequired

Newest first, capped at 48. Carries no donation amounts.

Show properties
Array of DonateSupporter
accountIdinteger<int32>required

The account id

min 0
avatarstringrequired

The avatar hash

namestringrequired

The account's display name

vanitystring | nullrequired

The account's vanity, null if it has none

500

Internal Server Error

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"
Try it
Server
Authorization
Request
curl -X POST 'https://api.steamsets.com/v1/donate.getGoal' \
  -H 'Authorization: Bearer YOUR_TOKEN'
Response
{
  "anonymousCount": 3,
  "goalCents": 50000,
  "month": "2026-08",
  "raisedCents": 34200,
  "supporterCount": 23,
  "supporters": [
    {
      "accountId": 123456,
      "avatar": "f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9",
      "name": "steamsets",
      "vanity": "string"
    }
  ]
}