v1

latestOpenAPI 3.0.0MIT (code only)2026-07-1783284693.9 KB
Commodities

List Game Commodities

Returns paginated game commodities with location data and resource metadata, optionally filtered to only those consumed by blueprints. Results include refined version info and starmap location data scoped to the requested or default game version.

get/api/commodities

Query parameters

pageinteger

Page number for pagination (starts at 1). Prefer using page[number] instead.

page[number]integer

Page number for pagination (starts at 1).

page[size]integer

Number of results per page. Maximum 200.

versionstring

Game version code to scope results to. Omit to use the current default version. Use GET /api/game-versions to list available versions and GET /api/game-versions/default to discover the default.

sortstring
Example:-rarity

Sort field. Prefix with "-" for descending. Supported: key, name, rarity, density, instability, resistance, signature.

filter[used]boolean

When true, only commodities used by blueprint ingredients in the requested or default game version are returned. Example: true

filter[system]string

Star system where the commodity can be found (see GET /api/commodities/filters for valid values). Example: Stanton System

filter[type]string

Location type name (see GET /api/commodities/filters for valid values). Example: Planet

filter[rarity]string

Commodity tier/rarity level, lowercase (see GET /api/commodities/filters for valid values). Example: epic

filter[kind]string

Resource kind (see GET /api/commodities/filters for valid values). Example: mineable

filter[group]string

Commodity group name. Comma-separated for multiple. Example: ProcessedGoods,Food

filter[refined_version]string

Refined version name (see GET /api/commodities/filters for valid values). Example: Agricium

filter[location]string

Partial match on starmap location name. Example: ArcCorp

filter[query]string

Search commodities by name or key. Example: Agricium

filter[ship]boolean

When true, only show commodities mineable by ships. Example: true

filter[ground_vehicle]boolean

When true, only show commodities mineable by ground vehicles. Example: true

filter[fps]boolean

When true, only show commodities mineable on foot (FPS). Example: true

filter[harvestable]boolean

When true, only show commodities collectible from harvestable or plant deposits. Example: true

filter[salvage]boolean

When true, only show commodities obtainable through salvage. Example: false

filter[mineable]boolean

When true, only show mineable commodities; when false, only show non-mineable. Example: true

Response

List of commodities

Example response

{
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5,
    "per_page": 30,
    "to": 30,
    "total": 150,
    "path": "https://api.star-citizen.wiki/api/vehicles"
  }
}