List spacecraft

Error

A valid request URL is required to generate request examples

{
  "content": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "launchMass": 11110,
      "lifecycleStatus": "Active",
      "name": "Hubble Space Telescope",
      "absorption": 0.4,
      "bodyShape": "BOX",
      "boxX": 1.5,
      "boxY": 1,
      "boxZ": 2,
      "color": "#FF5733",
      "cosparId": "1990-037B",
      "dragArea": 5,
      "dragCoefficient": 2.2,
      "dryMass": 10863,
      "externalKey": "PARTNER-SAT-001",
      "inertiaIxx": 1500,
      "inertiaIyy": 1700,
      "inertiaIzz": 2100,
      "noradId": "20580",
      "organizationId": "VALAR",
      "panels": [
        {
          "absorption": 0.3,
          "derivedNormal": {
            "x": 1,
            "y": 0,
            "z": 0
          },
          "doubleSided": true,
          "lengthM": 2,
          "mountAxisCustomX": 0,
          "mountAxisCustomY": 0,
          "mountAxisCustomZ": 5,
          "mountAxisPreset": "PLUS_Z",
          "mountPositionX": -1.5,
          "mountPositionY": 0,
          "mountPositionZ": 0.25,
          "name": "Port array",
          "panelIndex": 0,
          "rotationDeg": 90,
          "specularReflection": 0.2,
          "widthM": 1
        }
      ],
      "prismAxis": "Z",
      "prismComplementaryDiameter": 1,
      "prismDiameter": 0.866025,
      "prismDiameterMeasure": "INSCRIBED",
      "prismEdgeM": 0.5,
      "prismHeightM": 1,
      "prismSides": 6,
      "reflectivityCoefficient": 1,
      "specularReflection": 0.3,
      "srpArea": 5
    }
  ],
  "empty": false,
  "first": true,
  "hasNext": true,
  "hasPrevious": false,
  "last": false,
  "page": 0,
  "size": 20,
  "totalElements": 150,
  "totalPages": 8
}

{
  "code": "import.tracking.tdm.parse_failed",
  "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "details": {},
  "error": "Bad Request",
  "fieldErrors": {},
  "message": "Invalid spacecraft ID format",
  "params": {},
  "path": "/api/v1/stm/credentials",
  "status": 400,
  "timestamp": "2025-11-14T10:15:30.123Z"
}

{
  "error": "invalid_token",
  "error_description": "An error occurred while attempting to decode the Jwt"
}

{
  "code": "import.tracking.tdm.parse_failed",
  "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "details": {},
  "error": "Bad Request",
  "fieldErrors": {},
  "message": "Invalid spacecraft ID format",
  "params": {},
  "path": "/api/v1/stm/credentials",
  "status": 400,
  "timestamp": "2025-11-14T10:15:30.123Z"
}

GET

operations

spacecraft

Error

A valid request URL is required to generate request examples

{
  "content": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "launchMass": 11110,
      "lifecycleStatus": "Active",
      "name": "Hubble Space Telescope",
      "absorption": 0.4,
      "bodyShape": "BOX",
      "boxX": 1.5,
      "boxY": 1,
      "boxZ": 2,
      "color": "#FF5733",
      "cosparId": "1990-037B",
      "dragArea": 5,
      "dragCoefficient": 2.2,
      "dryMass": 10863,
      "externalKey": "PARTNER-SAT-001",
      "inertiaIxx": 1500,
      "inertiaIyy": 1700,
      "inertiaIzz": 2100,
      "noradId": "20580",
      "organizationId": "VALAR",
      "panels": [
        {
          "absorption": 0.3,
          "derivedNormal": {
            "x": 1,
            "y": 0,
            "z": 0
          },
          "doubleSided": true,
          "lengthM": 2,
          "mountAxisCustomX": 0,
          "mountAxisCustomY": 0,
          "mountAxisCustomZ": 5,
          "mountAxisPreset": "PLUS_Z",
          "mountPositionX": -1.5,
          "mountPositionY": 0,
          "mountPositionZ": 0.25,
          "name": "Port array",
          "panelIndex": 0,
          "rotationDeg": 90,
          "specularReflection": 0.2,
          "widthM": 1
        }
      ],
      "prismAxis": "Z",
      "prismComplementaryDiameter": 1,
      "prismDiameter": 0.866025,
      "prismDiameterMeasure": "INSCRIBED",
      "prismEdgeM": 0.5,
      "prismHeightM": 1,
      "prismSides": 6,
      "reflectivityCoefficient": 1,
      "specularReflection": 0.3,
      "srpArea": 5
    }
  ],
  "empty": false,
  "first": true,
  "hasNext": true,
  "hasPrevious": false,
  "last": false,
  "page": 0,
  "size": 20,
  "totalElements": 150,
  "totalPages": 8
}

{
  "code": "import.tracking.tdm.parse_failed",
  "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "details": {},
  "error": "Bad Request",
  "fieldErrors": {},
  "message": "Invalid spacecraft ID format",
  "params": {},
  "path": "/api/v1/stm/credentials",
  "status": 400,
  "timestamp": "2025-11-14T10:15:30.123Z"
}

{
  "error": "invalid_token",
  "error_description": "An error occurred while attempting to decode the Jwt"
}

{
  "code": "import.tracking.tdm.parse_failed",
  "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "details": {},
  "error": "Bad Request",
  "fieldErrors": {},
  "message": "Invalid spacecraft ID format",
  "params": {},
  "path": "/api/v1/stm/credentials",
  "status": 400,
  "timestamp": "2025-11-14T10:15:30.123Z"
}

Query Parameters

status

string

Lifecycle status filter (Active or Archived)

includeArchived

boolean

Include archived spacecraft when status is absent (true=all, false=active-only). Ignored when status is set.

noradId

string

Exact NORAD catalog number lookup filter. Exact string match — not numerically normalised (leading zeros are significant).

Maximum string length: 63

cosparId

string

Exact COSPAR international designator lookup filter.

Maximum string length: 20

name

string

Exact, case-insensitive spacecraft name lookup filter.

Maximum string length: 100

externalKey

string

Exact caller-assigned external-key lookup filter.

Maximum string length: 64

pageable

object

required

Show child attributes

Response

Spacecraft list retrieved successfully

Paginated response wrapper containing a page of results with navigation metadata

content

object[]

List of items in the current page

Show child attributes

empty

boolean

Whether the content list is empty

Example:

false

first

boolean

Whether this is the first page

Example:

true

hasNext

boolean

Whether there are more pages after this one

Example:

true

hasPrevious

boolean

Whether there are pages before this one

Example:

false

last

boolean

Whether this is the last page

Example:

false

page

integer<int32>

Current page number (0-indexed)

Example:

0

size

integer<int32>

Number of items per page

Example:

20

totalElements

integer<int64>

Total number of elements across all pages

Example:

150

totalPages

integer<int32>

Total number of pages

Example:

8

Spacecraft

State Vectors

Measurements

Query Parameters

Response