Get spacecraft by UUID

Error

A valid request URL is required to generate request examples

{
  "absorption": 0.4,
  "bodyShape": "BOX",
  "boxX": 1.5,
  "boxY": 1,
  "boxZ": 2,
  "color": "#FF5733",
  "cosparId": "2024-001A",
  "createdAt": "2023-11-07T05:31:56Z",
  "dragArea": 5,
  "dragCoefficient": 2.2,
  "dryMass": 450,
  "externalKey": "PARTNER-SAT-001",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "inertiaIxx": 1500,
  "inertiaIyy": 1700,
  "inertiaIzz": 2100,
  "launchMass": 500,
  "lifecycleStatus": "Active",
  "name": "Sentinel-1A",
  "noradId": 43013,
  "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,
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "absorption": 0.4,
  "bodyShape": "BOX",
  "boxX": 1.5,
  "boxY": 1,
  "boxZ": 2,
  "color": "#FF5733",
  "cosparId": "2024-001A",
  "createdAt": "2023-11-07T05:31:56Z",
  "dragArea": 5,
  "dragCoefficient": 2.2,
  "dryMass": 450,
  "externalKey": "PARTNER-SAT-001",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "inertiaIxx": 1500,
  "inertiaIyy": 1700,
  "inertiaIzz": 2100,
  "launchMass": 500,
  "lifecycleStatus": "Active",
  "name": "Sentinel-1A",
  "noradId": 43013,
  "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,
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "absorption": 0.4,
  "bodyShape": "BOX",
  "boxX": 1.5,
  "boxY": 1,
  "boxZ": 2,
  "color": "#FF5733",
  "cosparId": "2024-001A",
  "createdAt": "2023-11-07T05:31:56Z",
  "dragArea": 5,
  "dragCoefficient": 2.2,
  "dryMass": 450,
  "externalKey": "PARTNER-SAT-001",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "inertiaIxx": 1500,
  "inertiaIyy": 1700,
  "inertiaIzz": 2100,
  "launchMass": 500,
  "lifecycleStatus": "Active",
  "name": "Sentinel-1A",
  "noradId": 43013,
  "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,
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "absorption": 0.4,
  "bodyShape": "BOX",
  "boxX": 1.5,
  "boxY": 1,
  "boxZ": 2,
  "color": "#FF5733",
  "cosparId": "2024-001A",
  "createdAt": "2023-11-07T05:31:56Z",
  "dragArea": 5,
  "dragCoefficient": 2.2,
  "dryMass": 450,
  "externalKey": "PARTNER-SAT-001",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "inertiaIxx": 1500,
  "inertiaIyy": 1700,
  "inertiaIzz": 2100,
  "launchMass": 500,
  "lifecycleStatus": "Active",
  "name": "Sentinel-1A",
  "noradId": 43013,
  "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,
  "updatedAt": "2023-11-07T05:31:56Z"
}

GET

operations

spacecraft

{id}

Error

A valid request URL is required to generate request examples

{
  "absorption": 0.4,
  "bodyShape": "BOX",
  "boxX": 1.5,
  "boxY": 1,
  "boxZ": 2,
  "color": "#FF5733",
  "cosparId": "2024-001A",
  "createdAt": "2023-11-07T05:31:56Z",
  "dragArea": 5,
  "dragCoefficient": 2.2,
  "dryMass": 450,
  "externalKey": "PARTNER-SAT-001",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "inertiaIxx": 1500,
  "inertiaIyy": 1700,
  "inertiaIzz": 2100,
  "launchMass": 500,
  "lifecycleStatus": "Active",
  "name": "Sentinel-1A",
  "noradId": 43013,
  "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,
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "absorption": 0.4,
  "bodyShape": "BOX",
  "boxX": 1.5,
  "boxY": 1,
  "boxZ": 2,
  "color": "#FF5733",
  "cosparId": "2024-001A",
  "createdAt": "2023-11-07T05:31:56Z",
  "dragArea": 5,
  "dragCoefficient": 2.2,
  "dryMass": 450,
  "externalKey": "PARTNER-SAT-001",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "inertiaIxx": 1500,
  "inertiaIyy": 1700,
  "inertiaIzz": 2100,
  "launchMass": 500,
  "lifecycleStatus": "Active",
  "name": "Sentinel-1A",
  "noradId": 43013,
  "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,
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "absorption": 0.4,
  "bodyShape": "BOX",
  "boxX": 1.5,
  "boxY": 1,
  "boxZ": 2,
  "color": "#FF5733",
  "cosparId": "2024-001A",
  "createdAt": "2023-11-07T05:31:56Z",
  "dragArea": 5,
  "dragCoefficient": 2.2,
  "dryMass": 450,
  "externalKey": "PARTNER-SAT-001",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "inertiaIxx": 1500,
  "inertiaIyy": 1700,
  "inertiaIzz": 2100,
  "launchMass": 500,
  "lifecycleStatus": "Active",
  "name": "Sentinel-1A",
  "noradId": 43013,
  "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,
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "absorption": 0.4,
  "bodyShape": "BOX",
  "boxX": 1.5,
  "boxY": 1,
  "boxZ": 2,
  "color": "#FF5733",
  "cosparId": "2024-001A",
  "createdAt": "2023-11-07T05:31:56Z",
  "dragArea": 5,
  "dragCoefficient": 2.2,
  "dryMass": 450,
  "externalKey": "PARTNER-SAT-001",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "inertiaIxx": 1500,
  "inertiaIyy": 1700,
  "inertiaIzz": 2100,
  "launchMass": 500,
  "lifecycleStatus": "Active",
  "name": "Sentinel-1A",
  "noradId": 43013,
  "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,
  "updatedAt": "2023-11-07T05:31:56Z"
}

Path Parameters

string<uuid>

required

Spacecraft identifier (UUID)

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Response

Spacecraft retrieved successfully

Response containing spacecraft details

absorption

number<double>

Optical absorption coefficient α (dimensionless). Range (0.0, 1.0].

Example:

0.4

bodyShape

enum<string>

Body geometry primitive (BOX or REGULAR_PRISM).

Available options:

BOX,

REGULAR_PRISM

Example:

"BOX"

boxX

number<double>

Spacecraft box/bus X dimension (width) in meters

Example:

1.5

boxY

number<double>

Spacecraft box/bus Y dimension (height) in meters

Example:

1

boxZ

number<double>

Spacecraft box/bus Z dimension (length) in meters

Example:

2

color

string

Spacecraft color in hex format

Example:

"#FF5733"

cosparId

string

COSPAR international designator

Example:

"2024-001A"

createdAt

string<date-time>

Timestamp when the spacecraft was created

dragArea

number<double>

Operator-typed drag cross-sectional area in m² (null for pre-migration spacecraft)

Example:

5

dragCoefficient

number<double>

Drag coefficient

Example:

2.2

dryMass

number<double>

Mass without propellant in kg

Example:

450

externalKey

string

Caller-assigned external reference key (unique within your organization; immutable once set). Null when no key has been assigned.

Example:

"PARTNER-SAT-001"

string

Unique identifier of the spacecraft

Example:

"550e8400-e29b-41d4-a716-446655440000"

inertiaIxx

number<double>

Principal moment of inertia about the body's primary principal axis (kg·m²). Optional; null when inertia is not configured.

Example:

1500

inertiaIyy

number<double>

Principal moment of inertia about the body's secondary principal axis (kg·m²). Optional; null when inertia is not configured.

Example:

1700

inertiaIzz

number<double>

Principal moment of inertia about the body's tertiary principal axis (kg·m²). Optional; null when inertia is not configured.

Example:

2100

launchMass

number<double>

Total mass at launch in kg

Example:

500

lifecycleStatus

string

Lifecycle status of the spacecraft

Example:

"Active"

name

string

Name of the spacecraft

Example:

"Sentinel-1A"

noradId

integer<int32>

NORAD catalog number

Example:

43013

organizationId

string

Organization ID that owns this spacecraft

Example:

"VALAR"

panels

object[]

Per-panel rows (0..8). Each entry carries dimensions, attachment face, and orientation angles.

Show child attributes

prismAxis

enum<string>

Extrusion axis of the regular prism (DKR-1 §3.4). Populated only when bodyShape=REGULAR_PRISM; null otherwise.

Available options:

X,

Y,

Z

Example:

"Z"

prismComplementaryDiameter

number<double>

Cross-section diameter in the OTHER datum (the complement of prismDiameterMeasure), computed from edge + sides (DKR-1 §3.4). Populated only when bodyShape=REGULAR_PRISM; null otherwise.

Example:

1

prismDiameter

number<double>

Cross-section diameter in the operator's chosen datum (prismDiameterMeasure), computed from edge + sides (DKR-1 §3.4). Populated only when bodyShape=REGULAR_PRISM; null otherwise.

Example:

0.866025

prismDiameterMeasure

enum<string>

Which diameter datum the operator used to size the cross-section (DKR-1 §3.4). Populated only when bodyShape=REGULAR_PRISM; null otherwise.

Available options:

INSCRIBED,

CIRCUMSCRIBED

Example:

"INSCRIBED"

prismEdgeM

number<double>

Canonical regular-polygon edge length a in meters (DKR-1 §6) — the persisted source-of-truth cross-section dimension. Populated only when bodyShape=REGULAR_PRISM; null otherwise.

Example:

0.5

prismHeightM

number<double>

Regular-prism height L along the extrusion axis in meters. Populated only when bodyShape=REGULAR_PRISM; null otherwise.

Example:

1

prismSides

integer<int32>

Number of regular-polygon sides N (DKR-1 §3.4). Populated only when bodyShape=REGULAR_PRISM; null otherwise.

Example:

6

reflectivityCoefficient

number<double>

Reflectivity coefficient

Example:

1

specularReflection

number<double>

Optical specular-reflection coefficient ρs (dimensionless). Range [0.0, 1.0).

Example:

0.3

srpArea

number<double>

Operator-typed SRP cross-sectional area in m² (null for pre-migration spacecraft)

Example:

5

updatedAt

string<date-time>

Timestamp when the spacecraft was last updated

Spacecraft

State Vectors

Measurements

Path Parameters

Response