REST / MCP / SDK
UptimeScout API documentation
Service status, regional signals and history through REST, SDKs and MCP. Build dashboards and give AI assistants clear availability context.
Quickstart
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/servicesSearch and paginate the service catalog.GET /v1/statusRead the current saved status of one service.GET /v1/statusesRead multiple service statuses in one request.GET /v1/summarySummarize observed signals for a region or selected services.GET /v1/historyRead saved observations over time with pagination.GET /v1/statsCalculate ratios of saved signal samples, rather than measured uptime.GET /v1/incidentsList 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.
All servicesLicense 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.
Payments, renewals, plan changes and license management are handled by Evelode.com. The request allowance resets when the license is renewed or its plan is changed. It does not reset at the start of a calendar month. Annual plans include twelve monthly allowances as one request pool for the full license term. History accumulates from collection launch. The Free plan has no recurring charge.
PricingConnect an AI assistant
Add the server URL to your assistant, select OAuth, then sign in with Evelode or enter your license key on the connection screen. No client secret is needed.
https://mcp.uptimescout.com Authorization: Bearer YOUR_EVELODE_LICENSE_KEY
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.
Example from saved observations
{
"available_regions": [
"AE",
"AR",
"AT",
"AU",
"AZ",
"BD",
"BE",
"BG",
"BH",
"BR",
"CA",
"CH",
"CL",
"CO",
"CR",
"CZ",
"DE",
"DK",
"DO",
"DZ",
"EC",
"EG",
"ES",
"FI",
"FR",
"GB",
"GR",
"GT",
"HK",
"HR",
"HU",
"ID",
"IE",
"IL",
"IN",
"IT",
"JO",
"JP",
"KE",
"KR",
"MA",
"MX",
"MY",
"NG",
"NL",
"NO",
"NZ",
"PA",
"PE",
"PH",
"PK",
"PL",
"PR",
"PT",
"PY",
"RO",
"RS",
"RU",
"SA",
"SE",
"SG",
"SK",
"TH",
"TN",
"TR",
"TW",
"UA",
"US",
"UY",
"VE",
"VN",
"ZA"
],
"data_type": "availability_observations",
"generated_at": "2026-11-18T18:49:09.191958Z",
"region": "US",
"service": {
"age_seconds": 35,
"category": "it",
"description": "Platform for Git repositories, code collaboration, issues and software delivery.",
"description_language": "en",
"id": "github",
"logo_kind": "brand",
"logo_url": "https://uptimescout.com/static/brand-assets/github.svg?v=18e8fe76f953a31c",
"name": "GitHub",
"observed_at": "2026-11-18T18:48:33.509412Z",
"regions": [
"US"
],
"scope": "regional",
"signal": "reported_availability",
"stale": false,
"status": "outage"
},
"stale_after_seconds": 600,
"status": "ok"
}