API Reference

Services.

Query upstream service health and current status

GET/services

Bearer Token

List monitored services

Returns all third-party services your organization depends on (deduplicated across projects), with their current status.

Responses

Code Samples

curl -H 'Authorization: Bearer YOUR_API_KEY' \
  https://checkupstream.com/api/v1/services

GET/services/{id}

Bearer Token

Get service detail

Returns a service with its components and any active incidents. Use this to check the detailed health of a specific upstream dependency.

Parameters

idstringpathrequired

Service ID

Responses

Code Samples

curl -H 'Authorization: Bearer YOUR_API_KEY' \
  https://checkupstream.com/api/v1/services/svc_stripe

GET/services/{id}/impact

Bearer Token

Get service impact analysis

Analyze which of your projects are affected by a specific upstream service. Returns the list of projects that depend on this service, with the specific packages that create the dependency.

Parameters

idstringpathrequired

Service ID

Responses

Code Samples

curl -H 'Authorization: Bearer YOUR_API_KEY' \
  https://checkupstream.com/api/v1/services/svc_stripe/impact

Build with the API.

Generate an API token and start querying these endpoints from your CI, scripts, or backend services.

Get an API Token Read the SDK Reference