API · Devices

List devices

Fetch a batched list of every device on your account. Filter by replicant, device type, or location and page through results with a cursor. Useful for players managing hundreds or thousands of devices across multiple systems.

Endpoint

GET /v1/devices

Returns all active (non-decommissioned) devices owned by any replicant on the account. Each entry in the list is a full device details response.

Query parameters

Name	Type	Description
`replicant_code`	string · optional	Filter to a single replicant's devices.
`device_type`	string · optional	Filter by device type (e.g. `mining_drone`).
`location`	string · optional	Filter by location. A star code like `SOL` matches all devices in that system. A specific location like `SOL-1`, `SOL-BELT-1`, or `SOL-3-L4` matches that exact location.
`cursor`	integer · optional	Device ID to page from. Use `next_cursor` from the previous response.
`limit`	integer · optional	Number of devices to return, default 20 (max 50).

Pagination

Results are ordered by device ID. When more results are available, the response includes a next_cursor value. Pass it as the cursor query parameter on the next request to fetch the next page. When next_cursor is null, there are no more results.

Example

GET /v1/devices 200 OK

$ curl https://api.replicant.space/v1/devices?device_type=mining_drone&location=SOL&limit=2 \
    -H "Authorization: Bearer $API_KEY"

response response

{
  "devices": [
    {
      "device_code": "B58FCC78",
      "device_type": "mining_drone",
      "replicant_code": "4BBA7CBE",
      "location": "SOL-BELT-1",
      "features": [
        "cruise",
        "mine",
        "stow"
      ],
      "available_commands": [
        "change_owner",
        "deactivate",
        "decommission",
        "deploy",
        "recall",
        "retarget",
        "start_mining",
        "stow",
        "travel"
      ],
      "operational_capacity": 67.0,
      "status": "mining (rares)"
    },
    {
      "device_code": "9AC4E21F",
      "device_type": "mining_drone",
      "replicant_code": "4BBA7CBE",
      "location": "SOL-BELT-1",
      "features": [
        "cruise",
        "mine",
        "stow"
      ],
      "available_commands": [
        "change_owner",
        "deactivate",
        "decommission",
        "deploy",
        "recall",
        "retarget",
        "start_mining",
        "stow",
        "travel"
      ],
      "operational_capacity": 100.0,
      "status": "mining (silicates)"
    }
  ],
  "next_cursor": 4821
}