API Usage

Demo Scripts

The API can be accessed programmatically via any HTTP client. Python examples are available in the sbn-maqi-demo-scripts repository.

Workflow

Authenticate with your MAQI account, submit a read-only SQL query, poll the job status, and download the result CSV when the job reaches success or partial.

Endpoints

POST /api/auth/login

POST /api/query

GET /api/query/<job_id>

Minimal Requests

POST https://maqi-api.astro.umd.edu/api/auth/login
Content-Type: application/json

{
  "email": "you@example.edu",
  "password": "your-password"
}

POST https://maqi-api.astro.umd.edu/api/query
Authorization: Bearer <idToken>
Content-Type: application/json

{
  "query": "SELECT * FROM mpc_orbits LIMIT 10;"
}

GET https://maqi-api.astro.umd.edu/api/query/<job_id>
Authorization: Bearer <idToken>

Status Values

queued, processing, success, partial, error