GET
/
fleet
/
star-destroyers
Get Imperial Fleet Data
curl --request GET \
  --url https://api.empire.gov/v1/fleet/star-destroyers \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "data": {
    "vessels": [
      {
        "id": "ISD-001",
        "name": "Devastator",
        "class": "Imperial I-class Star Destroyer",
        "length": "1,600 meters",
        "crew": 47000,
        "commander": "Captain Bolvan",
        "sector": "Outer Rim",
        "status": "operational"
      }
    ],
    "total_count": 123,
    "page": 123,
    "per_page": 123
  }
}
This site is currently in alpha development. Content and features are actively being developed and may change.
This endpoint is currently in development. The example below shows placeholder data that demonstrates the expected response format.

​
Endpoint Overview

This endpoint will provide access to Imperial Fleet vessel information. Full functionality and real data will be available once the API is officially deployed. Example Endpoint: GET /api/v1/fleet/star-destroyers

​
Placeholder Response

The following is an example of what the response might look like when accessing Imperial fleet data: 
{
  "status": "success",
  "data": {
    "vessels": [
      {
        "id": "ISD-001",
        "name": "Devastator",
        "class": "Imperial I-class Star Destroyer",
        "length": "1,600 meters",
        "crew": 47000,
        "commander": "Captain Bolvan",
        "sector": "Outer Rim",
        "status": "operational"
      },
      {
        "id": "ISD-002",
        "name": "Avenger",
        "class": "Imperial II-class Star Destroyer",
        "length": "1,600 meters",
        "crew": 37000,
        "commander": "Captain Needa",
        "sector": "Mid Rim",
        "status": "operational"
      }
    ],
    "total_count": 25000,
    "page": 1,
    "per_page": 2
  }
}
Actual fleet data is classified. This is demonstration data only.

Authorizations

​
Authorization
string
header
required

Imperial Command authorization token. Contact your commanding officer for access credentials.

Query Parameters

​
limit
integer
default:10

The maximum number of vessels to return

Required range: x <= 100
​
sector
enum<string>

Filter by galactic sector

Available options:
Outer Rim,
Mid Rim,
Inner Rim,
Core Worlds

Response

200
application/json

Fleet data response

The response is of type object.