badge

List accounts that own a badge (earliest completion first). Donator perk — page size scales with Patreon tier.

Changed on
post/v1/badge.listCrafters

Request

  • Base URL: https://api.steamsets.com
  • URL: https://api.steamsets.com/v1/badge.listCrafters
  • Auth: HTTP bearer

Request body

$schemastring uri

A URL to the JSON Schema for this object.

badgeIdstring required

Badge id

cursorstring

Opaque pagination cursor from the previous page's nextCursor. Omit for the first page.

limitinteger

Page size (capped by donator tier)

pageinteger

1-based page to jump to. Use this or cursor, not both. Reaches at most 100000 crafters deep; walk with cursor past that.

Example request

{
  "$schema": "https://api.steamsets.com/schemas/BadgeListCraftersRequestBody.json"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

maxPageSizeinteger required

Largest page size your donator tier allows

nextCursorstring

Pass as cursor to fetch the next page. Absent when there are no more crafters.

pageinteger required

1-based page this response holds

pageSizeinteger required

Crafters per page used for this response

totalPagesinteger required

Pages available at this page size, capped at the deepest page a page jump can reach

trackedHoldersinteger required

Holders steamsets tracks for this badge

Example response

{
  "$schema": "https://api.steamsets.com/schemas/BadgeListCraftersResponseBody.json",
  "crafters": [
    {
      "apps": 123456,
      "avatar": "f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9",
      "awardsGiven": 123456,
      "awardsReceived": 123456,
      "badges": 123456,
      "city": {
        "name": "Bad Krozingen"
      },
      "country": {
        "code": "DE",
        "name": "Germany"
      },
      "createdAt": "2023-01-01T00:00:00Z",
      "donated": 123456,
      "economyBan": "steam",
      "foilBadges": 123456,
      "friends": 123456,
      "level": 123456,
      "name": "steamsets",
      "nameEffect": "rainbow",
      "normalBadges": 123456,
      "playtime": 123456,
      "pointsGiven": 123456,
      "pointsReceived": 123456,
      "privacy": "public",
      "region": {
        "name": "Europe"
      },
      "state": {
        "name": "Baden-Wurttemberg"
      },
      "steamId": "76561198842603734",
      "steamSetsVanity": "steamsets",
      "steamVanity": "steamsets",
      "supporter": {
        "active": true,
        "months": 3
      },
      "themeColor": "#FF5733",
      "xp": 123456
    }
  ]
}

Changes

  • 708b7ffcfba3Revision changes
    • warning

      added the new amber_glint enum value to the // response property for the response status

    • warning

      added the new amethyst_glint enum value to the // response property for the response status

    • warning

      added the new astral_sky enum value to the // response property for the response status

    • warning

      added the new boost enum value to the // response property for the response status

    • warning

      added the new cosmic enum value to the // response property for the response status

    • warning

      added the new crown enum value to the // response property for the response status

    • warning

      added the new developer_scan enum value to the // response property for the response status

    • warning

      added the new diamond_fire enum value to the // response property for the response status

    • warning

      added the new emerald_depth enum value to the // response property for the response status

    • warning

      added the new glass enum value to the // response property for the response status

    • warning

      added the new halo enum value to the // response property for the response status

    • warning

      added the new lens enum value to the // response property for the response status

    • warning

      added the new molten enum value to the // response property for the response status

    • warning

      added the new nebula_sky enum value to the // response property for the response status

    • warning

      added the new ruby_fire enum value to the // response property for the response status

    • warning

      added the new sakura enum value to the // response property for the response status

    • warning

      added the new sapphire_depth enum value to the // response property for the response status

    • warning

      added the new staff_scan enum value to the // response property for the response status

    • warning

      added the new stardust enum value to the // response property for the response status

    • info

      removed the glitch enum value from the // response property for the response status

    • info

      removed the retro enum value from the // response property for the response status

    • info

      removed the stamped enum value from the // response property for the response status

    • info

      removed the sunken enum value from the // response property for the response status

    • info

      removed the typewriter enum value from the // response property for the response status

  • 753b5a0546a3Revision changes
    • info

      added the optional property // to the response with the status