API Documentation

Access real-time AI provider status, incidents, uptime data, and supply chain information through our REST API.

Authentication

Include your API key in the request header. You can create API keys from your account dashboard.

curl https://aidown.io/api/v1/status \
  -H "X-API-Key: aist_your_key_here"

You can also use the Authorization: Bearer header format.

Rate Limits

Tier	Rate Limit	Price
Free	100 / day, 10 / min	$0
Pro	50,000 / day, 100 / min	$19/mo
Enterprise	Custom limits + SLA	Contact us

Rate limit headers are included on every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (daily), X-RateLimit-Burst-Limit, X-RateLimit-Burst-Remaining (per-minute).

Endpoints

GET/api/v1/status

Current status of all monitored AI providers.

Cache: 30s

Example

curl https://aidown.io/api/v1/status -H "X-API-Key: aist_..."

GET/api/v1/status/{provider}

Current status of a specific provider with service breakdown.

Cache: 30s

Parameters

provider — Provider slug (e.g., openai, anthropic, google-ai)

Example

curl https://aidown.io/api/v1/status/openai -H "X-API-Key: aist_..."

GET/api/v1/incidents

List recent incidents with filtering and pagination.

Cache: 60s

Parameters

page — Page number (default: 1)

limit — Results per page (default: 20, max: 100)

provider — Filter by provider slug

status — Filter by status: investigating, identified, monitoring, resolved

severity — Filter by severity: minor, major, critical

active — Set to "true" for unresolved only

since — ISO date — return incidents after this date

Example

curl "https://aidown.io/api/v1/incidents?provider=openai&active=true" \
  -H "X-API-Key: aist_..."

GET/api/v1/incidents/{id}

Detailed information about a specific incident.

Cache: 60s

Parameters

id — Incident UUID

Example

curl https://aidown.io/api/v1/incidents/550e8400-e29b-41d4-a716-446655440000 \
  -H "X-API-Key: aist_..."

GET/api/v1/uptime/{provider}

Uptime statistics and daily rollups for 7, 30, and 90-day windows.

Cache: 5m

Parameters

provider — Provider slug

Example

curl https://aidown.io/api/v1/uptime/anthropic -H "X-API-Key: aist_..."

GET/api/v1/supply-chain

AI infrastructure dependency graph with live status overlays.

Cache: 5m

Example

curl https://aidown.io/api/v1/supply-chain -H "X-API-Key: aist_..."

GET/api/v1/correlation

Active cross-provider correlation events (cascade detection).

Cache: 30s

Example

curl https://aidown.io/api/v1/correlation -H "X-API-Key: aist_..."

Code Examples

JavaScript / TypeScript

const API_KEY = 'aist_your_key_here';

const res = await fetch('https://aidown.io/api/v1/status', {
  headers: { 'X-API-Key': API_KEY },
});
const data = await res.json();

for (const provider of data.providers) {
  if (provider.status !== 'operational') {
    console.log(`${provider.providerSlug}: ${provider.status}`);
  }
}

Python

import requests

API_KEY = "aist_your_key_here"
headers = {"X-API-Key": API_KEY}

resp = requests.get("https://aidown.io/api/v1/status", headers=headers)
data = resp.json()

for provider in data["providers"]:
    if provider["status"] != "operational":
        print(f"{provider['providerSlug']}: {provider['status']}")

Scoring Methodology

Status and timeline data use the AI Intelligence Availability Score (AIAS), a composite metric that measures provider health across six dimensions: latency, time-to-first-token, error rate, rate limiting, official status, and data confidence. Individual provider scores are aggregated into the AI Health Index (AIHI), an ecosystem-wide health metric.

The scoring methodology is published as an open specification: AI Availability Score on GitHub.

Ready to get started?

Create a free account and get your API key in seconds.