Citra Space Alerts API
The alerts API from Citra Space — 5 operation(s) for alerts.
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-alerts-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 Alerts API
version: 0.1.0
tags:
- name: Alerts
paths:
/my/alerts:
delete:
operationId: delete_all_alerts_my_alerts_delete
parameters:
- in: query
name: page
required: false
schema:
default: 0
format: int64
minimum: 0
type: integer
- in: query
name: pageSize
required: false
schema:
default: 25
format: int64
maximum: 100
minimum: 1
type: integer
- description: JSON array of sort items
in: query
name: sort
required: false
schema:
type:
- string
- 'null'
- description: JSON array of filter items
in: query
name: filters
required: false
schema:
type:
- string
- 'null'
- description: Filter logic operator (and/or)
in: query
name: filterLogic
required: false
schema:
type:
- string
- 'null'
- in: query
name: quickFilter
required: false
schema:
type:
- string
- 'null'
- in: query
name: showDecayed
required: false
schema:
default: false
type: boolean
- in: query
name: showAllReviewStatuses
required: false
schema:
default: false
type: boolean
- in: query
name: includeRecentHits
required: false
schema:
default: false
type: boolean
- in: header
name: X-Scenario-Context
required: false
schema:
format: uuid
type:
- string
- 'null'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/DeletedAlertsResponse'
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Delete All Alerts
tags:
- Alerts
get:
operationId: list_user_alerts_my_alerts_get
parameters:
- in: query
name: page
required: false
schema:
default: 0
format: int64
minimum: 0
type: integer
- in: query
name: pageSize
required: false
schema:
default: 25
format: int64
maximum: 100
minimum: 1
type: integer
- description: JSON array of sort items
in: query
name: sort
required: false
schema:
type:
- string
- 'null'
- description: JSON array of filter items
in: query
name: filters
required: false
schema:
type:
- string
- 'null'
- description: Filter logic operator (and/or)
in: query
name: filterLogic
required: false
schema:
type:
- string
- 'null'
- in: query
name: quickFilter
required: false
schema:
type:
- string
- 'null'
- in: query
name: showDecayed
required: false
schema:
default: false
type: boolean
- in: query
name: showAllReviewStatuses
required: false
schema:
default: false
type: boolean
- in: query
name: includeRecentHits
required: false
schema:
default: false
type: boolean
- in: header
name: X-Scenario-Context
required: false
schema:
format: uuid
type:
- string
- 'null'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedResponse_Alert_'
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: List User Alerts
tags:
- Alerts
/my/alerts/mark-all-read:
put:
operationId: mark_all_alerts_as_read_my_alerts_mark_all_read_put
parameters:
- in: query
name: page
required: false
schema:
default: 0
format: int64
minimum: 0
type: integer
- in: query
name: pageSize
required: false
schema:
default: 25
format: int64
maximum: 100
minimum: 1
type: integer
- description: JSON array of sort items
in: query
name: sort
required: false
schema:
type:
- string
- 'null'
- description: JSON array of filter items
in: query
name: filters
required: false
schema:
type:
- string
- 'null'
- description: Filter logic operator (and/or)
in: query
name: filterLogic
required: false
schema:
type:
- string
- 'null'
- in: query
name: quickFilter
required: false
schema:
type:
- string
- 'null'
- in: query
name: showDecayed
required: false
schema:
default: false
type: boolean
- in: query
name: showAllReviewStatuses
required: false
schema:
default: false
type: boolean
- in: query
name: includeRecentHits
required: false
schema:
default: false
type: boolean
- in: header
name: X-Scenario-Context
required: false
schema:
format: uuid
type:
- string
- 'null'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/MarkedAlertsResponse'
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Mark All Alerts As Read
tags:
- Alerts
/my/alerts/unread-count:
get:
operationId: get_unread_count_my_alerts_unread_count_get
parameters:
- in: header
name: X-Scenario-Context
required: false
schema:
format: uuid
type:
- string
- 'null'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/UnreadCountResponse'
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Get Unread Count
tags:
- Alerts
/my/alerts/{alert_id}:
delete:
operationId: delete_alert_my_alerts__alert_id__delete
parameters:
- description: Alert ID
in: path
name: alert_id
required: true
schema:
format: uuid
type: string
- in: header
name: X-Scenario-Context
required: false
schema:
format: uuid
type:
- string
- 'null'
responses:
'204':
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Delete Alert
tags:
- Alerts
get:
operationId: get_alert_my_alerts__alert_id__get
parameters:
- description: Alert ID
in: path
name: alert_id
required: true
schema:
format: uuid
type: string
- in: header
name: X-Scenario-Context
required: false
schema:
format: uuid
type:
- string
- 'null'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Alert'
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Get Alert
tags:
- Alerts
/my/alerts/{alert_id}/read:
put:
operationId: mark_alert_as_read_my_alerts__alert_id__read_put
parameters:
- description: Alert ID
in: path
name: alert_id
required: true
schema:
format: uuid
type: string
- in: header
name: X-Scenario-Context
required: false
schema:
format: uuid
type:
- string
- 'null'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Alert'
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Mark Alert As Read
tags:
- Alerts
components:
schemas:
Alert:
properties:
alertType:
$ref: '#/components/schemas/AlertType'
creationEpoch:
format: date-time
type: string
eventEpoch:
format: date-time
type: string
eventType:
type:
- string
- 'null'
id:
format: uuid
type: string
isRead:
type: boolean
maneuverId:
format: uuid
type:
- string
- 'null'
maneuverStatus:
oneOf:
- type: 'null'
- $ref: '#/components/schemas/ManeuverStatus'
message:
type: string
missionId:
format: uuid
type:
- string
- 'null'
missionName:
type:
- string
- 'null'
newValue:
additionalProperties: {}
propertyNames:
type: string
type:
- object
- 'null'
readEpoch:
format: date-time
type:
- string
- 'null'
satelliteEventId:
format: uuid
type:
- string
- 'null'
satelliteEventType:
oneOf:
- type: 'null'
- $ref: '#/components/schemas/SatelliteEventType'
satelliteId:
format: uuid
type:
- string
- 'null'
satelliteName:
type:
- string
- 'null'
scenarioId:
format: uuid
type:
- string
- 'null'
sensorEventId:
format: uuid
type:
- string
- 'null'
sensorId:
format: uuid
type:
- string
- 'null'
sensorName:
type:
- string
- 'null'
sensorType:
oneOf:
- type: 'null'
- $ref: '#/components/schemas/SensorType'
subscriptionId:
format: uuid
type:
- string
- 'null'
title:
type: string
userGroupId:
format: uuid
type:
- string
- 'null'
userId:
format: uuid
type: string
required:
- id
- userId
- alertType
- title
- message
- isRead
- creationEpoch
- eventEpoch
type: object
AlertType:
enum:
- maneuver
- new_uct
- duplicate_uct
- satellite_event
- mission_event
- launch_warning
- launch_confirmed
- phase_transition_recommended
- custody_loss
- risk_category_change
- threat_object_correlated
- threat_assessment_stale
type: string
PaginatedResponse_Alert_:
properties:
hasNextPage:
readOnly: true
type: boolean
hasPreviousPage:
readOnly: true
type: boolean
items:
items:
$ref: '#/components/schemas/Alert'
type: array
page:
format: int64
minimum: 0
type: integer
pageSize:
format: int64
minimum: 1
type: integer
total:
format: int64
minimum: 0
type: integer
totalPages:
format: int64
readOnly: true
type: integer
required:
- items
- total
- page
- pageSize
- totalPages
- hasNextPage
- hasPreviousPage
type: object
MarkedAlertsResponse:
properties:
marked_count:
format: int64
minimum: 0
type: integer
required:
- marked_count
type: object
SatelliteEventType:
enum:
- rcs_updated
- ocs_updated
- stability_updated
- headcount_updated
- transmission_updated
- maneuver_detected
- drag_updated
- srp_updated
- new_elset
type: string
ManeuverStatus:
enum:
- unverified
- verified
- rejected
title: ManeuverStatus
type: string
SensorType:
enum:
- telescope
- antenna
title: SensorType
type: string
UnreadCountResponse:
properties:
count:
format: int64
type: integer
required:
- count
type: object
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
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
DeletedAlertsResponse:
properties:
deleted_count:
format: int64
minimum: 0
type: integer
required:
- deleted_count
type: object
securitySchemes:
HTTPBearer:
scheme: bearer
type: http