API Reference

The CheckUpstream REST API lets you programmatically query your projects, services, incidents, and impact analysis. All endpoints are served from https://checkupstream.com/api/v1

Authentication

All endpoints require a Bearer token from Settings → API Keys in your dashboard. Keys are 64-character hex strings.

Authorization: Bearer a1b2c3d4e5f6...

The telemetry endpoint uses an sdk_key field in the request body instead of the Authorization header.

Errors

All error responses follow a consistent JSON format:

{ "error": "Human-readable error message" }

Endpoints

Projects

1 endpoint

Manage monitored projects and their parsed dependencies

GET/projects

Services

3 endpoints

Query upstream service health and current status

GET/services

GET/services/{id}

GET/services/{id}/impact

Incidents

2 endpoints

Track active and resolved upstream incidents

GET/incidents

GET/incidents/{id}

Deploy Gate

1 endpoint

Pre-deployment safety checks — gate CI/CD pipelines on upstream health

GET/deploy-gate

Badge

1 endpoint

Embeddable SVG status badges for README files and dashboards

GET/badge/{orgSlug}

Telemetry

1 endpoint

Ingest SDK telemetry from your application runtime. Uses sdk_key body authentication instead of Bearer token.

POST/v1/events