JSON API Reference

Overview

All game data on salvageunion.io is available as machine-readable JSON. The API is static — every endpoint is a plain file served directly from the site. No authentication is required.

CORS is fully open (Access-Control-Allow-Origin: *), so you can fetch from any origin, including browser JavaScript.

Base URL: https://salvageunion.io

Tip: appending .json to any schema URL on this site returns the underlying data. For example, /schema/chassis renders the HTML index, and /schema/chassis.json serves the raw array. The same applies to individual entities: /schema/chassis/item/iron-mongrel.json.

Endpoints

GET

/schema/{schemaId}.json

Returns the full data array for a schema. Each element is a game entity.

Example: https://salvageunion.io/schema/chassis.json

[
  {
    "id": "iron-mongrel",
    "name": "Iron Mongrel",
    "hull": 30,
    "armor": 2,
    ...
  },
  ...
]

GET

/schema/{schemaId}.schema.json

Returns the JSON Schema definition for a schema, generated from the Zod validation schemas used in the SRD codebase. Useful for validating data or understanding the shape of entity objects.

Example: https://salvageunion.io/schema/chassis.schema.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": { "type": "string" },
      "name": { "type": "string" },
      ...
    }
  }
}

GET

/schema/{schemaId}/item/{itemId}.json

Returns a single entity by its slug. Entity slugs are lowercase, hyphen-separated versions of the entity name (e.g., Iron Mongrel becomes iron-mongrel). Slugs match the URLs used on the reference site.

Example: https://salvageunion.io/schema/chassis/item/iron-mongrel.json

{
  "id": "iron-mongrel",
  "name": "Iron Mongrel",
  "hull": 30,
  "armor": 2,
  ...
}

Usage Example

Fetch all chassis data in browser JavaScript:

const response = await fetch('https://salvageunion.io/schema/chassis.json')
const chassis = await response.json()
console.log(chassis[0].name) // "Iron Mongrel"

Available Schemas

The following schema IDs are available. Use them in the endpoint patterns above.

Schema ID	Name	Description	Items
abilities	Abilities	Pilot abilities and skills in Salvage Union	103
chassis	Chassis	Mech chassis definitions in Salvage Union	51
classes	Classes	Character classes in Salvage Union (base, advanced, and hybrid)	11
crawler-bays	Crawler Bays	Bays and facilities on Union Crawlers in Salvage Union	10
crawler-tech-levels	Crawler Tech Levels	Tech level progression for Union Crawlers in Salvage Union	6
crawlers	Crawlers	Union Crawler mobile bases in Salvage Union	5
creatures	Creatures	Creatures and wildlife in Salvage Union	13
distances	Distances	Distance bands and ranges in Salvage Union	4
drones	Drones	Autonomous drones in Salvage Union	13
equipment	Equipment	Pilot equipment and gear in Salvage Union	81
factions	Factions	Faction groups and organizations in Salvage Union	10
guides	Guides	Player-facing guides and processes in Salvage Union	15
keywords	Keywords	Game keywords and terminology in Salvage Union	82
meld	Meld	Meld-infected creatures in Salvage Union	5
modules	Modules	Mech modules in Salvage Union	83
npcs	NPCs	Non-player characters and people in Salvage Union	19
roll-tables	Roll Tables	Random tables and roll tables in Salvage Union	96
sources	Sources	Source books and expansions for Salvage Union content	10
squads	Squads	NPC squads and groups in Salvage Union	23
systems	Systems	Mech systems (weapons and utilities) in Salvage Union	128
tech-levels	Tech Levels	Tech level descriptions for Salvage Union	6
titans	Titans	Mech-scale single-threat enemies in Salvage Union (monsters and bosses)	13
traits	Traits	Traits and special properties in Salvage Union	45
vehicles	Vehicles	Conventional vehicles in Salvage Union	11

CORS Policy

All /schema/ endpoints include the following response headers:

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET
Content-Type: application/json

No preflight requests are required for standard GET requests.

Licensing

Data returned by this API is published under the Salvage Union Open Game License (OGL 1.0b) . Salvage Union is created and published by Leyline Press .