---
title: Status
description: Get the overall status of all your monitors with a single API call. Returns aggregate health and individual monitor states.
section:
  title: API Resources
  order: 7
order: 1
lastUpdated: 2026-02-14
---

The Status endpoint provides a consolidated view of your team's monitoring health, including the overall status and individual monitor states.

## GET /api/v1/status

Returns the overall status of all monitors in your team, along with a summary and details for each monitor.

**Required scope:** `monitors:read`

### Errors

| Status | Type | Description |
| --- | --- | --- |
| 401 | `unauthorized` | The API key is missing or invalid |
| 403 | `forbidden` | The API key lacks the required scope |

### Response Schema

```json
{
	"$schema": "https://json-schema.org/draft/2020-12/schema",
	"type": "object",
	"properties": {
		"data": {
			"type": "object",
			"properties": {
				"status": {
					"$ref": "#/$defs/TeamStatus"
				}
			},
			"required": [
				"status"
			]
		},
		"meta": {
			"type": "object",
			"properties": {
				"requestId": {
					"type": "string",
					"format": "uuid"
				},
				"timestamp": {
					"type": "string",
					"format": "date-time"
				}
			},
			"required": [
				"requestId",
				"timestamp"
			]
		}
	},
	"required": [
		"data",
		"meta"
	],
	"$defs": {
		"MonitorStatus": {
			"type": "object",
			"properties": {
				"id": {
					"type": "string",
					"pattern": "^mon_[0-7][0-9a-hjkmnp-tv-z]{25}$"
				},
				"name": {
					"type": "string"
				},
				"status": {
					"type": "string",
					"enum": [
						"up",
						"down",
						"unknown"
					],
					"description": "`unknown` until a completed check carries a status code"
				},
				"enabled": {
					"type": "boolean"
				},
				"lastCheck": {
					"type": [
						"integer",
						"null"
					],
					"description": "Epoch milliseconds"
				},
				"responseTimeMs": {
					"type": [
						"integer",
						"null"
					]
				}
			},
			"required": [
				"id",
				"name",
				"status",
				"enabled",
				"lastCheck",
				"responseTimeMs"
			]
		},
		"TeamStatus": {
			"type": "object",
			"properties": {
				"overall": {
					"type": "string",
					"enum": [
						"operational",
						"partial_outage",
						"major_outage",
						"unknown"
					],
					"description": "`unknown` when the team has no enabled monitor"
				},
				"monitors": {
					"type": "array",
					"items": {
						"$ref": "#/$defs/MonitorStatus"
					}
				},
				"summary": {
					"type": "object",
					"properties": {
						"total": {
							"type": "integer"
						},
						"up": {
							"type": "integer"
						},
						"down": {
							"type": "integer"
						},
						"degraded": {
							"type": "integer"
						},
						"unknown": {
							"type": "integer"
						}
					},
					"required": [
						"total",
						"up",
						"down",
						"degraded",
						"unknown"
					]
				}
			},
			"required": [
				"overall",
				"monitors",
				"summary"
			]
		}
	}
}
```

### Example Request

#### cURL

```bash
curl https://uptime.sergiodxa.com/api/v1/status \
  -H "Authorization: Bearer uptime_your_api_key"
```

### Response

```json
{
	"data": {
		"status": {
			"overall": "partial_outage",
			"monitors": [
				{
					"id": "mon_abc123",
					"name": "Production API",
					"status": "up",
					"enabled": true,
					"lastCheck": 1771065000000,
					"responseTimeMs": 142
				},
				{
					"id": "mon_def456",
					"name": "Marketing Website",
					"status": "down",
					"enabled": true,
					"lastCheck": 1771064985000,
					"responseTimeMs": 2340
				},
				{
					"id": "mon_ghi789",
					"name": "Staging Environment",
					"status": "unknown",
					"enabled": false,
					"lastCheck": null,
					"responseTimeMs": null
				}
			],
			"summary": {
				"total": 2,
				"up": 1,
				"down": 1,
				"degraded": 0,
				"unknown": 0
			}
		}
	},
	"meta": {
		"requestId": "6b1f9d5e-4a2c-4f7e-9a10-2c8d5f3b7e41",
		"timestamp": "2026-02-14T10:30:00.000Z"
	}
}
```

### Response Fields

All fields live under `data.status`.

| Field                       | Type           | Description                                                                                  |
| --------------------------- | -------------- | -------------------------------------------------------------------------------------------- |
| `overall`                   | string         | Overall team status: `operational`, `partial_outage`, `major_outage`, or `unknown`           |
| `monitors`                  | array          | Every HTTP monitor on the team, enabled or not, newest first                                 |
| `monitors[].id`             | string         | Unique monitor identifier                                                                    |
| `monitors[].name`           | string         | Display name of the monitor                                                                  |
| `monitors[].status`         | string         | `up`, `down`, or `unknown`, from the monitor's latest completed check                        |
| `monitors[].enabled`        | boolean        | Whether the monitor is actively checking                                                     |
| `monitors[].lastCheck`      | number \| null | When the latest check completed, in milliseconds since the epoch, or `null` if never checked |
| `monitors[].responseTimeMs` | number \| null | Response time of the latest check in milliseconds, or `null` if unavailable                  |
| `summary`                   | object         | Aggregate counts of monitor states                                                           |
| `summary.total`             | number         | Number of enabled monitors, the set `overall` is computed from; the other counts sum to it   |
| `summary.up`                | number         | Count of enabled monitors with `up` status                                                   |
| `summary.down`              | number         | Count of enabled monitors with `down` status                                                 |
| `summary.degraded`          | number         | Always `0`; monitors on this endpoint report `up`, `down`, or `unknown`                      |
| `summary.unknown`           | number         | Count of enabled monitors with `unknown` status                                              |

### Monitor Status Calculation

A monitor is `up` when its latest completed check returned the monitor's expected status code, `down` when it returned any other status code, and `unknown` when it has no completed check with a status code (never checked, or the latest check got no response).

### Overall Status Calculation

The `overall` field considers enabled monitors only:

- **operational** - No enabled monitor is `down`
- **partial_outage** - Some enabled monitors are `down`, but not all
- **major_outage** - All enabled monitors are `down`
- **unknown** - The team has no enabled monitors