# UptimeScout API documentation

Service status, regional signals and history through REST, SDKs and MCP. Build dashboards and give AI assistants clear availability context.

URL: https://uptimescout.com/docs/

## REST

```sh
curl -G https://api.uptimescout.com/v1/status --data-urlencode "service=github" --data-urlencode "region=US" -H "Authorization: Bearer $EVELODE_LICENSE_KEY"
```

## Available methods

- `GET /v1/services`: Search and paginate the service catalog.

- `GET /v1/status`: Read the current saved status of one service.

- `GET /v1/statuses`: Read multiple service statuses in one request.

- `GET /v1/summary`: Summarize observed signals for a region or selected services.

- `GET /v1/history`: Read saved observations over time with pagination.

- `GET /v1/stats`: Calculate ratios of saved signal samples, rather than measured uptime.

- `GET /v1/incidents`: List services with elevated signals; these are not confirmed global incidents.

## How the data works

UptimeScout stores regional observations in the background. Each response includes an observation time and freshness information. The same service may have different signals in different regions.

An operational signal means no issue was observed in that saved sample. Elevated or disruption signals describe observed conditions, not a confirmed global incident. Missing or stale observations are unknown. Sample ratios are not measured uptime percentages or an SLA.

The interface refreshes every minute. Check each service’s observation timestamp and freshness to assess how current its status is.

Language controls how information is presented; the observation region controls which country the data describes. You can switch them independently. A translated page does not automatically imply observations from a particular country.

## License and request limits

Use your Evelode license key as a Bearer token. Keep it on your server, outside browser code and public repositories. Only successful licensed data requests consume the allowance. Renewing a license or changing its plan starts a new allowance; calendar months do not reset it. Annual plans provide one request pool for the full annual license term.

## Connect an AI assistant

Connect a Streamable HTTP MCP client to the endpoint below and supply your license key in the Authorization header. Seven read-only tools provide service statuses, regional signals and history. The same license limits apply.

https://mcp.uptimescout.com

## Response handling

Check the HTTP status before reading data: 400 means invalid parameters, 401 or 403 indicates an authentication or license problem, 409 means the license entitlement changed during a request, 429 indicates a request or rate limit, and 503 means temporary unavailability. Respect retry delays and avoid tight retry loops.

OpenAPI: https://uptimescout.com/openapi.json
