Authentication

API Keys

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

Option 1: Header (Recommended)

Code
 
curl -H "X-API-Key: your-api-key" https://api.mission.space/api/v1/kp-index

Option 2: Query Parameter

Code
 
curl "https://api.mission.space/api/v1/kp-index?api_key=your-api-key"

Getting an API Key

The API is currently in closed beta. There is no self-service signup. To request access and an API key, submit a request via the Request Access page:

• Visit the Request Access page and complete the form with your name, organization, intended use, and contact email.
• After submitting, you will receive an acknowledgement email and we will review your request.
• If approved, you'll receive instructions by email (and access will be added to your dashboard) with details on how to retrieve your API key.

Using API Keys

Include your API key in the X-API-Key header or as the api_key query parameter for every request:

Code
 
curl -H "X-API-Key: sk_live_abc123..." https://api.mission.space/api/v1/kp-index

Example with cURL

Code
 
curl -H "X-API-Key: sk_live_abc123..." \
  -H "Content-Type: application/json" \
  "https://api.mission.space/api/v1/kp-index?start_time=2025-01-01T00:00:00Z&end_time=2025-01-31T23:59:59Z"

Example with Python

Code
 
import requests

headers = {

    "X-API-Key": "sk_live_abc123..."
  }

  response = requests.get(
    "https://api.mission.space/api/v1/kp-index",
    params={
      "start_time": "2025-01-01T00:00:00Z",
      "end_time": "2025-01-31T23:59:59Z"
    },
    headers=headers
  )

print(response.json())

Example with JavaScript

Code
 
const headers = {
  "X-API-Key": "sk_live_abc123..."
};

const response = await fetch(
  "https://api.mission.space/api/v1/kp-index?start_time=2025-01-01T00:00:00Z&end_time=2025-01-31T23:59:59Z",
  { headers }
);

const data = await response.json();
console.log(data);

Security

• Never commit API keys to version control
• Rotate keys regularly
• Use environment variables for API keys in production
• Report compromised keys immediately

Error Handling

If you receive a 401 Unauthorized error:

• Verify your API key is correct
• Check the X-API-Key header or api_key query parameter is present
• Ensure the key hasn't expired
• Generate a new key if needed