Mission Space Public API

Models

Endpointhttps://api.mission.space/api/v1

Space weather data and atmospheric model API providing solar wind, geomagnetic indices, and models.

⚠️ API Under Construction
This API is currently in development. Endpoints and data formats are subject to change. Production availability coming soon.

Data Overview

Kp Index: 3-hourly geomagnetic activity (0-9 scale)
Magnetic Field: Solar wind Bx/By/Bz from DSCOVR L1
Solar Wind: Speed, density, temperature, pressure from DSCOVR L1
Proton Flux: Energy channels >0.5-100 MeV from GOES
X-Ray Flux: GOES classification (A/B/C/M/X-class)
Satellite Data: POES high-latitude and GOES geostationary measurements
Events: Coronal mass ejections
Models: JB2008 and MSIS atmospheric density/temperature calculations

Getting Started

To use this API, you'll need an API key. Request API access here to get started.

Detailed Guides

POES Satellite Data Guide - Learn about POES satellite measurements (154+ types), active satellites (NOAA15/18/19, MetOp01/03), and 1B+ records
GOES Satellite Data Guide - Learn about GOES satellite measurements (167+ types), active satellites (GOES16/17/18/19), and 34M+ records

Authentication

All API endpoints (except /health) require authentication using an API key. You can authenticate in two ways:

Option 1: Header (Recommended)

Code
 
X-API-Key: your_api_key_here

Option 2: Query Parameter

Code
 
?api_key=your_api_key_here

Rate Limits

Rate limit information is included in response headers:

X-RateLimit-Limit: Requests allowed per minute
X-RateLimit-Remaining: Remaining requests in current window

Limits:

200 req/min

Common Parameters

Time Parameters:

All data endpoints require ISO 8601 timestamps (e.g., "2025-01-01T00:00:00Z")
Maximum query span: 365 days per request
Times are always in UTC

Pagination:

limit: 1-10000 records per page (default 1000)
offset: Skip N records (default 0)

Field Units & Descriptions

Field	Unit	Typical Range	Source
Kp Index	0-9 (half-steps)	0-9	USGS
Bx, By, Bz	nanoTesla (nT)	±100	DSCOVR
Solar Wind Speed	km/s	250-600	DSCOVR
Density	particles/cm³	1-20	DSCOVR
Temperature	Kelvin	10K-100K	DSCOVR
Proton Flux	protons/(cm²·s·sr)	0.1-1000	GOES
X-Ray Flux	W/m²	1e-7 to 1e-2	GOES
Thermosphere Density	kg/m³	1e-15 to 1e-11	Models
Temperature	Kelvin	500-2000	Models

Atmospheric model calculations

Calculate density with JB2008 model

POST

https://api.mission.space/api/v1

/models/jb2008

Predict atmospheric density at specified location and time using JB2008 atmospheric model

Calculate density with JB2008 model › Request Body

timestamp

string · date-time · required

Date and time in ISO 8601 format

latitude

number · min: -90 · max: 90 · required

Geographic latitude (-90 to 90 degrees)

longitude

number · min: -180 · max: 180 · required

Geographic longitude (-180 to 180 degrees)

altitude_km

number · min: 90 · max: 1500 · required

Altitude above sea level (90 to 1500 km)

f107

number

Solar flux F10.7 (optional, uses current value if not specified)

ap

number

Ap geomagnetic index (optional, uses current value if not specified)

Calculate density with JB2008 model › Responses

Successful calculation

status

string

object

POST/models/jb2008

curl --request POST \
  --url https://api.mission.space/api/v1/models/jb2008 \
  --header 'Content-Type: application/json' \
  --data '
{
  "timestamp": "2025-01-01T12:00:00Z",
  "latitude": 45,
  "longitude": 15,
  "altitude_km": 500
}
'

shell

Example Request Body

{
  "timestamp": "2025-01-01T12:00:00Z",
  "latitude": 45,
  "longitude": 15,
  "altitude_km": 500
}

json

application/json

Example Responses

{
  "status": "success",
  "data": {
    "timestamp": "2025-01-01T12:00:00Z",
    "latitude": 45,
    "longitude": 15,
    "altitude_km": 500,
    "density_kg_m3": 1.2e-11,
    "temperature_K": 1050
  }
}

json

application/json

Calculate atmosphere with NRLMSIS model

POST

https://api.mission.space/api/v1

/models/msis

Predict temperature and density profiles using NRLMSIS 2.0 model

Calculate atmosphere with NRLMSIS model › Request Body

timestamp

string · date-time · required

Date and time in ISO 8601 format

latitude

number · min: -90 · max: 90 · required

Geographic latitude (-90 to 90 degrees)

longitude

number · min: -180 · max: 180 · required

Geographic longitude (-180 to 180 degrees)

altitude_km

number · min: 0 · max: 1000 · required

Altitude above sea level (0 to 1000 km)

f107

number

Solar flux F10.7 (optional, currently accepted but not used)

ap

number

Ap geomagnetic index (optional, currently accepted but not used)

Calculate atmosphere with NRLMSIS model › Responses

Successful calculation

status

string

object

POST/models/msis

curl --request POST \
  --url https://api.mission.space/api/v1/models/msis \
  --header 'Content-Type: application/json' \
  --data '
{
  "timestamp": "2025-01-01T12:00:00Z",
  "latitude": 45,
  "longitude": 15,
  "altitude_km": 100,
  "f107": 150,
  "ap": 25
}
'

shell

Example Request Body

{
  "timestamp": "2025-01-01T12:00:00Z",
  "latitude": 45,
  "longitude": 15,
  "altitude_km": 100,
  "f107": 150,
  "ap": 25
}

json

application/json

Example Responses

No example specified for this content type

application/json

Data - Events Utility

Data Overview

Kp Index: 3-hourly geomagnetic activity (0-9 scale)

Magnetic Field: Solar wind Bx/By/Bz from DSCOVR L1

Solar Wind: Speed, density, temperature, pressure from DSCOVR L1

Proton Flux: Energy channels >0.5-100 MeV from GOES

X-Ray Flux: GOES classification (A/B/C/M/X-class)

Satellite Data: POES high-latitude and GOES geostationary measurements

Events: Coronal mass ejections

Models: JB2008 and MSIS atmospheric density/temperature calculations

Getting Started

To use this API, you'll need an API key. Request API access here to get started.

Detailed Guides

POES Satellite Data Guide - Learn about POES satellite measurements (154+ types), active satellites (NOAA15/18/19, MetOp01/03), and 1B+ records

GOES Satellite Data Guide - Learn about GOES satellite measurements (167+ types), active satellites (GOES16/17/18/19), and 34M+ records

Field Units & Descriptions

Field

Unit

Typical Range

Source

Kp Index

0-9 (half-steps)

0-9

USGS

Bx, By, Bz

nanoTesla (nT)

±100

DSCOVR

Solar Wind Speed

km/s

250-600

DSCOVR

Density

particles/cm³

1-20

DSCOVR

Temperature

Kelvin

10K-100K

DSCOVR

Proton Flux

protons/(cm²·s·sr)

0.1-1000

GOES

X-Ray Flux

W/m²

1e-7 to 1e-2

GOES

Thermosphere Density

kg/m³

1e-15 to 1e-11

Models

Temperature

Kelvin

500-2000

Models

Calculate density with JB2008 model

POST

https://api.mission.space/api/v1

/models/jb2008

Predict atmospheric density at specified location and time using JB2008 atmospheric model

Calculate density with JB2008 model › Request Body

timestamp

string · date-time · required

Date and time in ISO 8601 format

latitude

number · min: -90 · max: 90 · required

Geographic latitude (-90 to 90 degrees)

longitude

number · min: -180 · max: 180 · required

Geographic longitude (-180 to 180 degrees)

altitude_km

number · min: 90 · max: 1500 · required

Altitude above sea level (90 to 1500 km)

f107

number

Solar flux F10.7 (optional, uses current value if not specified)

ap

number

Ap geomagnetic index (optional, uses current value if not specified)

Calculate density with JB2008 model › Responses

Successful calculation

status

string

object

Calculate atmosphere with NRLMSIS model

POST

https://api.mission.space/api/v1

/models/msis

Predict temperature and density profiles using NRLMSIS 2.0 model

Calculate atmosphere with NRLMSIS model › Request Body

timestamp

string · date-time · required

Date and time in ISO 8601 format

latitude

number · min: -90 · max: 90 · required

Geographic latitude (-90 to 90 degrees)

longitude

number · min: -180 · max: 180 · required

Geographic longitude (-180 to 180 degrees)

altitude_km

number · min: 0 · max: 1000 · required

Altitude above sea level (0 to 1000 km)

f107

number

Solar flux F10.7 (optional, currently accepted but not used)

ap

number

Ap geomagnetic index (optional, currently accepted but not used)

Calculate atmosphere with NRLMSIS model › Responses

Successful calculation

status

string

object