Game Data - Blueprints

Get user inventory

Changed on

Get user's blueprint inventory

Returns all blueprints owned by the authenticated user with acquisition details. Supports filtering by category, rarity, and version. Displays acquisition progress and statistics.

Requirements:

  • 30.1: Record which blueprints each player owns
  • 30.2: Display owned blueprint count vs. total available
  • 30.3: Display acquisition date for each blueprint
  • 30.4: Support filtering blueprints by owned status
  • 30.5: Display acquisition progress
  • 30.6: Support bulk import of owned blueprints
  • 44.3: Allow players to mark blueprints as owned/not owned
  • 44.4: Display owned blueprint count vs. total available
  • 44.5: Support filtering blueprints by owned status
  • 44.6: Display acquisition progress
  • 44.7: Sync blueprint inventory across devices
  • 44.8: Support bulk import of blueprint lists
  • 44.9: Display recently acquired blueprints
  • 44.10: Support blueprint collection goals and achievements
get/game-data/blueprints/inventory

Request

  • Base URL: /api/v2 (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v2/game-data/blueprints/inventory
  • Auth: loggedin (a scheme the document does not define)

Query parameters

item_categorystring

Filter by item category

raritystring

Filter by rarity

version_idstring

Game version ID (defaults to active LIVE version)

sort_by'acquisition_date' | 'blueprint_name'

Sort field (acquisition_date, blueprint_name)

sort_order'asc' | 'desc'

Sort order (asc, desc)

pagenumber double

Page number (default: 1)

page_sizenumber double

Results per page (default: 50, max: 100)

Response

User's blueprint inventory with statistics

page_sizenumber double required
pagenumber double required
totalnumber double required

Changes

    • ○

      the endpoint scheme security loggedin was added to the API

    • ○

      the endpoint scheme security jwt was removed from the API