Default

Gets a list of satellites

get

https://api.orc.com/v1https://api.orc.com

/satellites

Returns a list of all satellites

Query parameters

satellitesToRetrieveinteger · int32Required

Number of satellites to retrieve

Responses

200

A list of satellites

application/json

get

/satellites

HTTPcURLJavaScriptPython

GET /v1/satellites?satellitesToRetrieve=1 HTTP/1.1
Host: api.orc.com
Accept: */*

200

A list of satellites

[
  {
    "id": 9,
    "name": "Asteroid Incinerator",
    "owner": "Laser Industries",
    "status": 1
  },
  {
    "id": 10,
    "name": "CleaningBot 1009",
    "owner": "CL4PTRAP",
    "status": 0
  }
]

Gets a satellite by ID

get

https://api.orc.com/v1https://api.orc.com

/satellites/{id}

Gets a satellite with the specified ID

Path parameters

idinteger · int64Required

Satellite ID

Responses

200

Satellite information retrieved successfully

application/json

get

/satellites/{id}

HTTPcURLJavaScriptPython

GET /v1/satellites/{id} HTTP/1.1
Host: api.orc.com
Accept: */*

200

Satellite information retrieved successfully

{
  "id": 9,
  "name": "Asteroid Incinerator",
  "owner": "Laser Industries",
  "status": 1
}

Updates a satellite

put

https://api.orc.com/v1https://api.orc.com

/satellites/{id}

Updates a satellite with the specified ID

Path parameters

idinteger · int64Required

Satellite ID

Body

application/json

idinteger · int64Required

namestringRequired

ownerstringRequired

statusinteger · int64Required

Responses

200

Satellite information updated successfully

application/json

put

/satellites/{id}

HTTPcURLJavaScriptPython

PUT /v1/satellites/{id} HTTP/1.1
Host: api.orc.com
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "id": 1,
  "name": "text",
  "owner": "text",
  "status": 1
}

200

Satellite information updated successfully

{
  "id": 9,
  "name": "Asteroid Slingshotter",
  "owner": "Laser Industries",
  "status": 1
}

Deletes a satellite

delete

https://api.orc.com/v1https://api.orc.com

/satellites/{id}

Deletes a satellite with the specified ID

Path parameters

idinteger · int64Required

Satellite ID

Responses

200

Satellite deleted successfully

application/json

delete

/satellites/{id}

HTTPcURLJavaScriptPython

DELETE /v1/satellites/{id} HTTP/1.1
Host: api.orc.com
Accept: */*

200

Satellite deleted successfully

{
  "message": "Satellite deleted successfully"
}

Schedules decommission for the given satellite

post

https://api.orc.com/v1https://api.orc.com

/satellites/scheduleDecommission

Schedules a decommission for the satellite with the specified ID

Body

application/json

satelliteIdinteger · int64Required

decommissionAtstring · date-timeRequired

Responses

200

Satellite decommission scheduled successfully

application/json

400

Bad Request

application/json

500

A problem occurred while attempting to schedule the satellite decommission.

application/json

post

/satellites/scheduleDecommission

HTTPcURLJavaScriptPython

POST /v1/satellites/scheduleDecommission HTTP/1.1
Host: api.orc.com
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "satelliteId": 1,
  "decommissionAt": "2026-01-16T01:41:36.891Z"
}

{
  "message": "Decommission scheduled successfully"
}