Skip to main content

List equipment, loot chests, and external rewards

These endpoints let you read game content and catalog data for your vendor.

Integrators typically use them to:

  • Build admin UIs / internal tools
  • Validate IDs before calling “assign rewards”
  • Show content previews (equipment icons, loot chest contents, external reward names)

High-level flow​

Equipment​

List equipment (paginated)​

  • Method: GET
  • Path: /api/v1/equipment
  • Auth: Any (user or app).
    Note: app auth may return a reduced field set compared to user auth.

Common query params (all optional):

  • page, limit
  • sortBy (e.g. equipmentId, price, worth, slot, rarity, name, power)
  • slot (filter by slot)

curl

curl -X GET "https://your-api/api/v1/equipment?page=1&limit=20&sortBy=price" \
  -H "Authorization: Bearer <token>"

Get one equipment item​

  • Method: GET
  • Path: /api/v1/equipment/{id}
curl -X GET "https://your-api/api/v1/equipment/eq-helm-1" \
  -H "Authorization: Bearer <token>"

Loot chests​

List loot chests (paginated)​

  • Method: GET
  • Path: /api/v1/lootchests
  • Auth: Any.
curl -X GET "https://your-api/api/v1/lootchests?page=1&limit=20" \
  -H "Authorization: Bearer <token>"

Get one loot chest​

Some deployments expose GET /api/v1/lootchests/{id}.
Check your OpenAPI spec for availability and the exact path.

External rewards​

External rewards are rewards fulfilled in your own systems (CRM/API). See External rewards.

List external rewards (paginated)​

  • Method: GET
  • Path: /api/v1/externalRewards
  • Auth: Any, with externalRewards:read scope.
curl -X GET "https://your-api/api/v1/externalRewards?page=1&limit=20" \
  -H "Authorization: Bearer <token>"

Get one external reward​

  • Method: GET
  • Path: /api/v1/externalRewards/{id}
  • Auth: Any, with externalRewards:read scope.
curl -X GET "https://your-api/api/v1/externalRewards/welcome-bonus-10" \
  -H "Authorization: Bearer <token>"

Practical tip: validate before granting​

Before you call Assign rewards on-demand, you can validate the IDs you plan to grant:

  • equipment: GET /api/v1/equipment/{id}
  • external reward: GET /api/v1/externalRewards/{id}
  • loot chest: list endpoint (and single endpoint if available)

Response shapes​

For exact response schemas (pagination wrapper, filters, reduced app-auth shapes), see the OpenAPI specification at shared/src/docs/openapi-savagetech.json under:

  • Equipment
  • Loot Chests
  • External Rewards