Citra Space Launch Definitions API

The launch_definitions API from Citra Space — 4 operation(s) for launch_definitions.

Operations 6

GET /launch-definitions List Launch Definitions #
POST /launch-definitions Create Launch Definition #
GET /launch-definitions/{definition_id} Get Launch Definition #
PATCH /launch-definitions/{definition_id} Update Launch Definition #
GET /launch-definitions/{definition_id}/warnings List Launch Definition Warnings #
GET /launch-sites List Launch Sites #

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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/citra-space:citra-space-launch-definitions-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

citra-space-launch-definitions-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: SOICAT Launch Definitions API
  version: 0.1.0
tags:
- name: launch_definitions
paths:
  /launch-definitions:
    get:
      operationId: list_launch_definitions_launch_definitions_get
      parameters:
      - in: header
        name: X-Scenario-Context
        required: false
        schema:
          format: uuid
          type:
          - string
          - 'null'
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/LaunchDefinitionRead'
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      summary: List Launch Definitions
      tags:
      - launch_definitions
    post:
      operationId: create_launch_definition_launch_definitions_post
      parameters:
      - in: header
        name: X-Scenario-Context
        required: false
        schema:
          format: uuid
          type:
          - string
          - 'null'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LaunchDefinitionCreate'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LaunchDefinitionRead'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      summary: Create Launch Definition
      tags:
      - launch_definitions
  /launch-definitions/{definition_id}:
    get:
      operationId: get_launch_definition_launch_definitions__definition_id__get
      parameters:
      - description: The launch definition ID
        in: path
        name: definition_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/LaunchDefinitionRead'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      summary: Get Launch Definition
      tags:
      - launch_definitions
    patch:
      operationId: update_launch_definition_launch_definitions__definition_id__patch
      parameters:
      - description: The launch definition ID
        in: path
        name: definition_id
        required: true
        schema:
          format: uuid
          type: string
      - in: header
        name: X-Scenario-Context
        required: false
        schema:
          format: uuid
          type:
          - string
          - 'null'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LaunchDefinitionUpdate'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LaunchDefinitionRead'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      summary: Update Launch Definition
      tags:
      - launch_definitions
  /launch-definitions/{definition_id}/warnings:
    get:
      operationId: list_launch_definition_warnings_launch_definitions__definition_id__warnings_get
      parameters:
      - description: The launch definition ID
        in: path
        name: definition_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:
                items:
                  $ref: '#/components/schemas/LaunchWarningRead'
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      summary: List Launch Definition Warnings
      tags:
      - launch_definitions
  /launch-sites:
    get:
      description: Public launch-site names for the ground-station name autocomplete (code + name only).
      operationId: list_launch_sites_launch_sites_get
      parameters:
      - in: header
        name: X-Scenario-Context
        required: false
        schema:
          format: uuid
          type:
          - string
          - 'null'
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/LaunchSiteName'
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      summary: List Launch Sites
      tags:
      - launch_definitions
components:
  schemas:
    UserTier:
      enum:
      - Standard
      - Plus
      - Premium
      - Enterprise
      - Government
      - Admin
      type: string
    LaunchStatus:
      enum:
      - projected
      - indicated
      - confirmed
      - in_flight
      - inserted
      - concluded
      - false_alarm
      type: string
    LaunchDefinitionRead:
      description: Launch definition returned by the public API.
      properties:
        ascentParams:
          additionalProperties: {}
          propertyNames:
            type: string
          type: object
        corridors:
          items:
            $ref: '#/components/schemas/CorridorSnapshot'
          type: array
        createdAt:
          format: date-time
          type: string
        estimatedT0:
          format: date-time
          type:
          - string
          - 'null'
        groundStationId:
          format: uuid
          type:
          - string
          - 'null'
        id:
          format: uuid
          type: string
        missionId:
          format: uuid
          type:
          - string
          - 'null'
        scenarioId:
          format: uuid
          type:
          - string
          - 'null'
        site:
          additionalProperties: {}
          propertyNames:
            type: string
          type: object
        status:
          $ref: '#/components/schemas/LaunchStatus'
        t0Confidence:
          format: double
          maximum: 1
          minimum: 0
          type:
          - number
          - 'null'
        targetRegime:
          maxLength: 64
          type:
          - string
          - 'null'
        updatedAt:
          format: date-time
          type: string
        userGroupId:
          format: uuid
          type:
          - string
          - 'null'
        userId:
          format: uuid
          type:
          - string
          - 'null'
        userTier:
          $ref: '#/components/schemas/UserTier'
        vehicleProfile:
          additionalProperties: {}
          propertyNames:
            type: string
          type: object
        windowEnd:
          format: date-time
          type:
          - string
          - 'null'
        windowStart:
          format: date-time
          type:
          - string
          - 'null'
      required:
      - id
      - userTier
      - status
      - createdAt
      - updatedAt
      type: object
    LaunchSiteName:
      description: Public launch-site name suggestion (code + name only; no coordinates).
      properties:
        name:
          type: string
        siteCode:
          type: string
      required:
      - siteCode
      - name
      type: object
    LaunchWarningRead:
      description: Launch warning returned by the public API.
      properties:
        confidence:
          format: double
          type:
          - number
          - 'null'
        createdAt:
          format: date-time
          type: string
        estimatedT0:
          format: date-time
          type:
          - string
          - 'null'
        eventKey:
          type:
          - string
          - 'null'
        id:
          format: uuid
          type: string
        launchDefinitionId:
          format: uuid
          type:
          - string
          - 'null'
        payloadHint: {}
        raw:
          additionalProperties: {}
          propertyNames:
            type: string
          type: object
        scenarioId:
          format: uuid
          type:
          - string
          - 'null'
        site:
          additionalProperties: true
          type:
          - object
          - 'null'
        source:
          type: string
        sourceEventId:
          type: string
        userGroupId:
          format: uuid
          type:
          - string
          - 'null'
        userId:
          format: uuid
          type:
          - string
          - 'null'
        userTier:
          $ref: '#/components/schemas/UserTier'
        vehicleHint: {}
        windowEnd:
          format: date-time
          type:
          - string
          - 'null'
        windowStart:
          format: date-time
          type:
          - string
          - 'null'
      required:
      - id
      - userTier
      - source
      - sourceEventId
      - raw
      - createdAt
      type: object
    LaunchDefinitionUpdate:
      description: 'Documentation-only PATCH schema. Runtime parsing uses a tri-state model so

        omitted and explicit-null nullable fields stay distinct.'
      properties:
        ascentParams:
          additionalProperties: true
          type:
          - object
          - 'null'
        corridors:
          items:
            $ref: '#/components/schemas/CorridorSnapshot'
          minItems: 1
          type:
          - array
          - 'null'
        estimatedT0:
          format: date-time
          type:
          - string
          - 'null'
        groundStationId:
          format: uuid
          type:
          - string
          - 'null'
        site:
          additionalProperties: true
          type:
          - object
          - 'null'
        status:
          oneOf:
          - type: 'null'
          - $ref: '#/components/schemas/LaunchStatus'
        t0Confidence:
          format: double
          maximum: 1
          minimum: 0
          type:
          - number
          - 'null'
        targetRegime:
          maxLength: 64
          type:
          - string
          - 'null'
        vehicleProfile:
          additionalProperties: true
          type:
          - object
          - 'null'
        windowEnd:
          format: date-time
          type:
          - string
          - 'null'
        windowStart:
          format: date-time
          type:
          - string
          - 'null'
      type: object
    LaunchDefinitionCreate:
      description: Launch definition creation schema.
      properties:
        ascentParams:
          additionalProperties: {}
          propertyNames:
            type: string
          type: object
        corridors:
          items:
            $ref: '#/components/schemas/CorridorSnapshot'
          minItems: 1
          type: array
        estimatedT0:
          format: date-time
          type:
          - string
          - 'null'
        groundStationId:
          format: uuid
          type: string
        id:
          format: uuid
          type:
          - string
          - 'null'
        scenarioId:
          format: uuid
          type:
          - string
          - 'null'
        site:
          additionalProperties: {}
          propertyNames:
            type: string
          type: object
        t0Confidence:
          format: double
          maximum: 1
          minimum: 0
          type:
          - number
          - 'null'
        targetRegime:
          maxLength: 64
          type:
          - string
          - 'null'
        vehicleProfile:
          additionalProperties: {}
          propertyNames:
            type: string
          type: object
        windowEnd:
          format: date-time
          type:
          - string
          - 'null'
        windowStart:
          format: date-time
          type:
          - string
          - 'null'
      required:
      - groundStationId
      - corridors
      type: object
    CorridorSnapshot:
      description: A corridor frozen onto a launch definition.
      properties:
        azMax:
          format: double
          maximum: 360
          minimum: 0
          type: number
        azMin:
          format: double
          maximum: 360
          minimum: 0
          type: number
        id:
          format: uuid
          type: string
        label:
          maxLength: 64
          minLength: 1
          type: string
        source:
          default: station
          enum:
          - station
          - custom
          type: string
        stationCorridorId:
          format: uuid
          type:
          - string
          - 'null'
      required:
      - label
      - azMin
      - azMax
      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
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http