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	103
bio-titans	Bio-Titans	Mech-scale biological monsters	12
chassis	Chassis	Mech chassis definitions	51
classes	Classes	Pilot Classes (Base and Hybrid)	11
crawler-bays	Crawler Bays	Bays and facilities on Union Crawlers	10
crawler-tech-levels	Crawler Tech Levels	Tech level progression for Union Crawlers	6
crawlers	Crawlers	Union Crawler mobile bases	5
creatures	Creatures	Creatures and wildlife	13
distances	Distances	Distance bands and ranges	4
drones	Drones	Autonomous drones	14
equipment	Equipment	Pilot equipment and gear	82
factions	Factions	Faction groups and organizations	10
guides	Guides	Player-facing guides and processes	15
keywords	Keywords	Game keywords and terminology	82
meld	Meld	Meld-infected creatures	5
modules	Modules	Mech modules	83
npcs	NPCs	Non-player characters and people	19
roll-tables	Roll Tables	Random tables and roll tables	96
sources	Sources	Source books and expansions	10
squads	Squads	NPC squads and groups	23
systems	Systems	Mech systems (weapons and utilities)	128
tech-levels	Tech Levels	Tech level descriptions	6
traits	Traits	Traits and special properties	45
vehicles	Vehicles	Conventional vehicles	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 Licence (OGL 1.0b). Salvage Union is created and published by Leyline Press.

The licence covers game text and mechanics only. Entity artwork is not covered — those images are used on this site with special permission from Leyline Press and may not be redistributed. Republication of licensed text must include the legal notices required by the Salvage Union Open Game Licence 1.0b.