Citra Space Satellite Groups API
The satellite_groups API from Citra Space — 7 operation(s) for satellite_groups.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/citra-space:citra-space-satellite-groups-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: SOICAT Satellite Groups API
version: 0.1.0
tags:
- name: satellite_groups
paths:
/my/satellite-groups:
get:
operationId: list_user_satellite_groups_my_satellite_groups_get
parameters:
- in: query
name: ids
required: false
schema:
items:
type: string
type:
- array
- 'null'
- in: header
name: X-Scenario-Context
required: false
schema:
type:
- string
- 'null'
responses:
'200':
content:
application/json:
schema:
items:
$ref: '#/components/schemas/SatelliteGroup'
type: array
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: List User Satellite Groups
tags:
- satellite_groups
/my/satellite-groups/favorites:
get:
operationId: list_favorite_satellite_groups_my_satellite_groups_favorites_get
parameters:
- in: header
name: X-Scenario-Context
required: false
schema:
type:
- string
- 'null'
responses:
'200':
content:
application/json:
schema:
items:
$ref: '#/components/schemas/SatelliteGroup'
type: array
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: List Favorite Satellite Groups
tags:
- satellite_groups
/satellite-groups:
get:
operationId: list_satellite_groups_satellite_groups_get
parameters:
- in: query
name: ids
required: false
schema:
items:
type: string
type:
- array
- 'null'
- in: header
name: X-Scenario-Context
required: false
schema:
type:
- string
- 'null'
responses:
'200':
content:
application/json:
schema:
items:
$ref: '#/components/schemas/SatelliteGroup'
type: array
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: List Satellite Groups
tags:
- satellite_groups
post:
operationId: create_satellite_groups_satellite_groups_post
parameters:
- in: header
name: X-Scenario-Context
required: false
schema:
type:
- string
- 'null'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SatelliteGroupCreateList'
required: true
responses:
'201':
content:
application/json:
schema:
items:
format: uuid
type: string
type: array
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Create Satellite Groups
tags:
- satellite_groups
put:
operationId: upsert_satellite_groups_satellite_groups_put
parameters:
- in: header
name: X-Scenario-Context
required: false
schema:
type:
- string
- 'null'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SatelliteGroupUpsertList'
required: true
responses:
'200':
content:
application/json:
schema:
items:
format: uuid
type: string
type: array
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Upsert Satellite Groups
tags:
- satellite_groups
/satellite-groups/{group_id}:
delete:
operationId: delete_satellite_group_satellite_groups__group_id__delete
parameters:
- in: path
name: group_id
required: true
schema:
type: string
- in: header
name: X-Scenario-Context
required: false
schema:
type:
- string
- 'null'
responses:
'204':
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Delete Satellite Group
tags:
- satellite_groups
get:
operationId: get_satellite_group_satellite_groups__group_id__get
parameters:
- in: path
name: group_id
required: true
schema:
type: string
- in: header
name: X-Scenario-Context
required: false
schema:
type:
- string
- 'null'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/SatelliteGroup'
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Get Satellite Group
tags:
- satellite_groups
/satellite-groups/{group_id}/favorite:
delete:
operationId: unfavorite_satellite_group_satellite_groups__group_id__favorite_delete
parameters:
- in: path
name: group_id
required: true
schema:
type: string
- in: header
name: X-Scenario-Context
required: false
schema:
type:
- string
- 'null'
responses:
'200':
content:
application/json:
schema: {}
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Unfavorite Satellite Group
tags:
- satellite_groups
post:
operationId: favorite_satellite_group_satellite_groups__group_id__favorite_post
parameters:
- in: path
name: group_id
required: true
schema:
type: string
- in: header
name: X-Scenario-Context
required: false
schema:
type:
- string
- 'null'
responses:
'200':
content:
application/json:
schema: {}
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Favorite Satellite Group
tags:
- satellite_groups
/satellite-groups/{group_id}/satellites:
delete:
operationId: remove_satellites_from_group_satellite_groups__group_id__satellites_delete
parameters:
- in: path
name: group_id
required: true
schema:
type: string
- in: header
name: X-Scenario-Context
required: false
schema:
type:
- string
- 'null'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SatelliteGroupRemoveSatellites'
required: true
responses:
'200':
content:
application/json:
schema: {}
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Remove Satellites From Group
tags:
- satellite_groups
get:
operationId: get_satellites_for_group_satellite_groups__group_id__satellites_get
parameters:
- in: path
name: group_id
required: true
schema:
format: uuid
type: string
- in: header
name: X-Scenario-Context
required: false
schema:
type:
- string
- 'null'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/SatelliteSummaryList'
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Get Satellites For Group
tags:
- satellite_groups
post:
operationId: add_satellites_to_group_satellite_groups__group_id__satellites_post
parameters:
- in: path
name: group_id
required: true
schema:
type: string
- in: header
name: X-Scenario-Context
required: false
schema:
type:
- string
- 'null'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SatelliteGroupAddSatellites'
required: true
responses:
'200':
content:
application/json:
schema: {}
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Add Satellites To Group
tags:
- satellite_groups
/satellites/{satellite_id}/groups:
get:
operationId: list_satellite_groups_for_satellite_satellites__satellite_id__groups_get
parameters:
- in: path
name: satellite_id
required: true
schema:
type: string
- in: header
name: X-Scenario-Context
required: false
schema:
type:
- string
- 'null'
responses:
'200':
content:
application/json:
schema:
items:
$ref: '#/components/schemas/SatelliteGroup'
type: array
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: List Satellite Groups For Satellite
tags:
- satellite_groups
components:
schemas:
UserTier:
enum:
- Standard
- Plus
- Premium
- Enterprise
- Government
- Admin
type: string
MissionCategory:
enum:
- Communications
- Imaging
- Science & Technology
- Calibration
- Spaceship
- Navigation
- Sigint
- Meteorology
- Radar Imaging
- Early Warning
- Earth Observation Science
- Classified
title: MissionCategory
type: string
SatelliteType:
enum:
- Rocket Body
- Payload
- Debris
- Unknown
type: string
SatelliteGroupUpsert:
properties:
details:
type:
- string
- 'null'
id:
anyOf:
- format: uuid
type: string
- type: string
- type: 'null'
satelliteIds:
description: Initial members on create only; updates must use explicit add/remove endpoints
items:
format: uuid
type: string
type:
- array
- 'null'
title:
maxLength: 255
minLength: 1
type:
- string
- 'null'
userTier:
default: Standard
oneOf:
- $ref: '#/components/schemas/UserTier'
type: object
SatelliteGroupUpsertList:
items:
$ref: '#/components/schemas/SatelliteGroupUpsert'
type: array
SatelliteGroupCreateList:
items:
$ref: '#/components/schemas/SatelliteGroupCreate'
type: array
SatelliteProvenance:
enum:
- space_track
- udl_elset
- uct_discovery
- user
- unknown
type: string
SatelliteGroupRemoveSatellites:
properties:
satelliteIds:
items:
format: uuid
type: string
type: array
type: object
SatelliteGroup:
properties:
creationEpoch:
type: string
details:
type:
- string
- 'null'
id:
format: uuid
type: string
isFavorited:
default: false
type: boolean
managedBy:
type:
- string
- 'null'
satelliteIds:
items:
format: uuid
type: string
type: array
scenarioId:
format: uuid
type:
- string
- 'null'
title:
maxLength: 255
minLength: 1
type: string
updateEpoch:
type: string
userGroupId:
format: uuid
type:
- string
- 'null'
userId:
format: uuid
type: string
userTier:
default: Standard
oneOf:
- $ref: '#/components/schemas/UserTier'
username:
type:
- string
- 'null'
required:
- id
- title
- userId
- creationEpoch
- updateEpoch
type: object
ValidationError:
properties:
ctx:
type: object
input: {}
loc:
items:
oneOf:
- type: string
- format: int64
type: integer
type: array
msg:
type: string
type:
type: string
required:
- loc
- msg
- type
type: object
SatelliteSummaryList:
items:
$ref: '#/components/schemas/SatelliteSummary'
type: array
ManeuverCapability:
enum:
- Maneuverable
- Not Maneuverable
- Unknown
type: string
Sector:
enum:
- Commercial
- Civil
- Defense
- Amateur
title: Sector
type: string
SatelliteGroupAddSatellites:
properties:
satelliteIds:
items:
format: uuid
type: string
type: array
type: object
ReviewStatus:
enum:
- needs_review
- in_review
- approved
- rejected
- migrated
- blocked
title: ReviewStatus
type: string
SatelliteSummary:
properties:
aliasCount:
format: int64
type: integer
altitudeDisplay:
type:
- string
- 'null'
altitudeKm:
format: double
type:
- number
- 'null'
bus:
type:
- string
- 'null'
countryCode:
type:
- string
- 'null'
countryIso:
type:
- string
- 'null'
countryName:
type:
- string
- 'null'
coverageDescription:
type:
- string
- 'null'
coverageType:
type:
- string
- 'null'
creationEpoch:
type: string
decayEpoch:
type:
- string
- 'null'
depthM:
format: double
type:
- number
- 'null'
diameterM:
format: double
type:
- number
- 'null'
dryMassKg:
format: double
type:
- number
- 'null'
elsetCount:
format: int64
type: integer
headcount:
format: int64
type:
- integer
- 'null'
heightM:
format: double
type:
- number
- 'null'
id:
type: string
isStable:
type:
- boolean
- 'null'
launchDateEpoch:
type:
- string
- 'null'
launchSiteName:
type:
- string
- 'null'
maneuverCapability:
default: Unknown
oneOf:
- $ref: '#/components/schemas/ManeuverCapability'
manufacturer:
type:
- string
- 'null'
massKg:
format: double
type:
- number
- 'null'
mission:
oneOf:
- type: 'null'
- $ref: '#/components/schemas/MissionCategory'
name:
type:
- string
- 'null'
noradCatId:
format: int64
type:
- integer
- 'null'
observedRcsMax:
format: double
type:
- number
- 'null'
observedRcsMin:
format: double
type:
- number
- 'null'
observedRcsUpdatedAt:
type:
- string
- 'null'
observedVmagMax:
format: double
type:
- number
- 'null'
observedVmagMin:
format: double
type:
- number
- 'null'
observedVmagUpdatedAt:
type:
- string
- 'null'
orbitRegime:
type:
- string
- 'null'
orbitRegimeFullName:
type:
- string
- 'null'
originType:
type:
- string
- 'null'
owner:
type:
- string
- 'null'
ownerGroupName:
type:
- string
- 'null'
provenance:
default: unknown
oneOf:
- $ref: '#/components/schemas/SatelliteProvenance'
recentHits:
format: int64
type:
- integer
- 'null'
reviewStatus:
default: approved
oneOf:
- $ref: '#/components/schemas/ReviewStatus'
rotationPeriodSec:
format: double
type:
- number
- 'null'
secondaryMission:
oneOf:
- type: 'null'
- $ref: '#/components/schemas/MissionCategory'
sector:
oneOf:
- type: 'null'
- $ref: '#/components/schemas/Sector'
shape:
type:
- string
- 'null'
site:
type:
- string
- 'null'
spanM:
format: double
type:
- number
- 'null'
stabilityCalculatedAt:
type:
- string
- 'null'
transmissionCount:
format: int64
type: integer
type:
$ref: '#/components/schemas/SatelliteType'
widthM:
format: double
type:
- number
- 'null'
xSectAvgM2:
format: double
type:
- number
- 'null'
xSectMaxM2:
format: double
type:
- number
- 'null'
xSectMinM2:
format: double
type:
- number
- 'null'
required:
- id
- creationEpoch
- type
- aliasCount
- elsetCount
- transmissionCount
type: object
SatelliteGroupCreate:
properties:
details:
type:
- string
- 'null'
satelliteIds:
items:
format: uuid
type: string
type: array
title:
maxLength: 255
minLength: 1
type: string
userTier:
default: Standard
oneOf:
- $ref: '#/components/schemas/UserTier'
required:
- title
type: object
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
type: object
securitySchemes:
HTTPBearer:
scheme: bearer
type: http