API Reference

POST /api/v1/auth
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "your-password"
}

{
  "token": "Aha8iPmNDFr76K6jhweaLEHf",
  "user": {
    "id": 1,
    "email": "user@example.com",
    "first_name": "John",
    "last_name": "Doe"
  }
}

Authorization: Bearer YOUR_API_TOKEN

{
  "error": {
    "code": "TIMESTAMP_OUTSIDE_WINDOW",
    "message": "timestamp outside analysis window",
    "details": {
      "valid_range": {
        "start": "2025-12-06T08:00:00Z",
        "end": "2025-12-13T08:00:00Z"
      }
    }
  },
  "meta": {
    "request_id": "a702aa12-...",
    "timestamp": "2025-12-09T10:30:00Z"
  }
}

import requests

API_BASE = "https://app.vega.space/api/v1"
TOKEN = "YOUR_API_TOKEN"

headers = {"Authorization": f"Bearer {TOKEN}"}

# Get interference at location
response = requests.get(
    f"{API_BASE}/interference/at_point",
    headers=headers,
    params={
        "tracked_satellite_id": 84,
        "lat": 45.0,
        "lon": -120.0,
        "timestamp": "2025-12-06T08:05:00Z"
    }
)

result = response.json()
data = result["data"]
print(f"Interference: {data['intensity']} satellites")
print(f"Risk level: {data['risk_level']}")
print(f"Request ID: {result['meta']['request_id']}")

const API_BASE = 'https://app.vega.space/api/v1';
const TOKEN = 'YOUR_API_TOKEN';

async function getInterference(lat, lon, timestamp, satelliteId) {
  const params = new URLSearchParams({
    tracked_satellite_id: satelliteId,
    lat: lat,
    lon: lon,
    timestamp: timestamp
  });

  const response = await fetch(
    `${API_BASE}/interference/at_point?${params}`,
    { headers: { 'Authorization': `Bearer ${TOKEN}` } }
  );

  return response.json();
}

// Usage
const result = await getInterference(45.0, -120.0, '2025-12-06T08:05:00Z', 84);
const { data, meta } = result;
console.log(`Interference: ${data.intensity} satellites`);
console.log(`Risk level: ${data.risk_level}`);