Developer API Reference

Integrate live spaceflight telemetry databases directly into your client apps with our free public JSON API.

General Guidelines

The Antariksh API is a free, key-authenticated, rate-limited interface hosted on Cloudflare's edge workers.

Base Endpoint: https://antariksh.sattamlabs.com
Response Format: application/json
CORS Access: Allowed (Access-Control-Allow-Origin: *)
Auth: Authorization: Bearer <your-key> (get one at /dashboard)
Rate limit: 120 requests / minute per key (429 on exceed)
Edge Caching: Automatic invalidations occur on registry synchronization events.

GET/api/v1/health

Retrieve sync status and version health indicators of the Antariksh DB engine.

Sample cURL Request

curl -i "https://antariksh.sattamlabs.com/api/v1/health"

Sample JSON Response

{
  "status": "healthy",
  "last_sync": "2026-07-19T11:00:00Z",
  "cache_version": "3",
  "sync_sources": [
    {
      "source": "isro_launches",
      "status": "ok",
      "message": "inserted=105 updated=54",
      "ran_at": "2026-07-19 11:00:00"
    }
  ]
}

GET/api/v1/launches

Retrieve a paginated, filterable manifest of past ISRO space launches.

Query Parameters

Parameter	Type	Description
page	integer	Page offset (default: 1)
perPage	integer	Results per page limit (default: 50, max: 100)
vehicle	string	Filter by launcher code (e.g. PSLV-XL) or family (PSLV)
status	string	Filter by outcome (SUCCESSFUL, UNSUCCESSFUL, PARTIAL)
year	string	Filter by launch year (e.g. 2026)
sort	string	Sort date direction (date_asc, date_desc)

Sample cURL Request

curl -i "https://antariksh.sattamlabs.com/api/v1/launches?vehicle=PSLV-XL&status=SUCCESSFUL&perPage=1"

Sample JSON Response

{
  "data": [
    {
      "id": 12,
      "serialNumber": 94,
      "slug": "pslv-c57-aditya-l1-mission",
      "name": "PSLV-C57/Aditya-L1 Mission",
      "launchDate": "2023-09-02",
      "vehicleCode": "PSLV-XL",
      "payload": "Aditya-L1 payloads",
      "missionStatus": "SUCCESSFUL",
      "orbitType": "L1",
      "launchSite": "SDSC SHAR",
      "isroLink": "https://www.isro.gov.in/pslvc57-adityal1-mission",
      "ll2Id": "876a40a5-e36b-4e89-bdc9-598d1a1005a9",
      "imageUrl": "https://images.thespacedevs.com/launch_images/...",
      "description": "Aditya-L1 is India's first solar research spacecraft...",
      "updatedAt": "2026-07-19T11:00:00.000Z"
    }
  ],
  "meta": {
    "total": 24,
    "page": 1,
    "perPage": 1
  }
}

GET/api/v1/launches/:slug

Fetch details for a single mission identified by its slug.

Query Parameters

Parameter	Type	Description
slug	string	Required. Launcher slug (e.g. pslv-c57-aditya-l1-mission)

Sample cURL Request

curl -i "https://antariksh.sattamlabs.com/api/v1/launches/pslv-c57-aditya-l1-mission"

Sample JSON Response

{
  "data": {
    "id": 12,
    "serialNumber": 94,
    "slug": "pslv-c57-aditya-l1-mission",
    "name": "PSLV-C57/Aditya-L1 Mission",
    "launchDate": "2023-09-02",
    "vehicleCode": "PSLV-XL",
    ...
  }
}

GET/api/v1/upcoming

Retrieve pending flights currently on ISRO's schedule.

Sample cURL Request

curl -i "https://antariksh.sattamlabs.com/api/v1/upcoming"

Sample JSON Response

{
  "data": [
    {
      "id": 1,
      "ll2Id": "ll2-up-1",
      "name": "Gaganyaan-1",
      "vehicle": "LVM-3",
      "netDate": "2026-09-30T00:00:00.000Z",
      "pad": "Second Launch Pad",
      "orbit": "LEO",
      "status": "TBD",
      "description": "First crewless orbital flight test of Gaganyaan capsule.",
      "imageUrl": "https://img.com/gaganyaan.jpg",
      "updatedAt": "2026-07-19T11:00:00.000Z"
    }
  ]
}

GET/api/v1/stats

Retrieve precomputed analytics datasets for dashboards and visualization engines.

Sample cURL Request

curl -i "https://antariksh.sattamlabs.com/api/v1/stats"

Sample JSON Response

{
  "data": {
    "totals": {
      "launches": 105,
      "successful": 94,
      "unsuccessful": 8,
      "partial": 3,
      "successRate": 89.5,
      "spacecraft": 135,
      "vehicles": 11
    },
    "perYear": [
      { "year": 1979, "successful": 0, "unsuccessful": 1, "partial": 0, "total": 1 }
      ...
    ],
    "perVehicle": [
      { "family": "PSLV", "total": 60, "successful": 57, "successRate": 95 }
    ],
    ...
  }
}