API · Locations

Location details

Get whatever the API knows about a place. The response shape depends on what kind of location you ask for - stars, belts, planets and moons all return different fields.

Endpoint

GET /v1/locations/{code}

Stars

If {code} is a star (for example TARAZEDAR), the response is identical to a fresh system scan - the star's planets, belts, lagrange points and any system hub. See replicants/scan for the full response shape.

Belts

Belt responses describe the asteroid field itself - overall density and the scarcity of each resource type. Density level ranges from sparse to dense. Scarcity levels range from scarce to rich.

GET /v1/locations/{code} 200 OK

$ curl https://api.replicant.space/v1/locations/TARAZEDAR-BELT-1 \
    -H "Authorization: Bearer $API_KEY"

response response

{
  "location_type": "belt",
  "location": "TARAZEDAR-BELT-1",
  "belt": {
    "density": "sparse",
    "designation": "TARAZEDAR-BELT-1",
    "inner_radius_au": 0.6,
    "outer_radius_au": 0.9,
    "resources": {
      "carbon": "rich",
      "conductive": "scarce",
      "rares": "low",
      "silicates": "low",
      "structural": "moderate",
      "volatiles": "high"
    }
  },
  "devices": [],
  "inventory": [],
  "resource_sites": []
}

Planets and moons

Planet and moon responses only include resource site details once you've sent a survey drone to the location.

GET /v1/locations/{code} 200 OK

$ curl https://api.replicant.space/v1/locations/TARAZEDAR-2-3 \
    -H "Authorization: Bearer $API_KEY"

response response

{
  "moon": {
    "atmo_o2_pct": null,
    "atmo_pressure_atm": null,
    "atmo_toxicity": null,
    "atmosphere": false,
    "biosphere_index": null,
    "category": "frozen",
    "density_gcc": 2.61,
    "designation": "DELTA-3-1",
    "has_subsurface_ocean": false,
    "hydrosphere_pct": null,
    "life_stage": "none",
    "location_type": "rocky",
    "mass_earth": 0.005969,
    "name": null,
    "orbital_distance_km": 27567.1,
    "orbital_period_hours": 48.31,
    "radius_earth": 0.2328,
    "scanned": true,
    "surface_gravity": 0.1101,
    "surface_temp_c": -111.0,
    "surface_temp_k": 162.0,
    "tags": [
      "cratered",
      "rocky"
    ],
    "tectonic_index": null,
    "tidally_locked": true,
    "type": "rocky"
  }
}

Your devices and resources

Any non-star location response also includes devices, inventory totals and resource_sites for that location.