# List monitors

`GET /service/@id/uptime/monitors` · Tino Uptime, service owner's sign-in token

The account's monitors, filtered by state (`state`) and type (`type`), searched by name or target (`q`); cursor pagination (`next_cursor`). Each monitor has its latest state, last check, latency, open incident and 30-day uptime.

## HTTP request

| Item | Value |
| --- | --- |
| URL | `https://api.tino.vn/service/@id/uptime/monitors` |
| Method | `GET` |
| Authentication | the Tino Uptime service owner's sign-in token (`Authorization: Bearer <token>`); the `/v1` gateway does not expose Tino Uptime yet |
| Content-Type | — (no body) |

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | int | yes | Tino Uptime service ID |
| `state` | query | string | no | Filter by state: `pending`, `up`, `suspect`, `down`, `partial`, `down_international`, `paused` |
| `type` | query | string | no | Filter by type (`settings.type`) |
| `q` | query | string | no | Search the name or target, case-insensitive |
| `limit` | query | int | no | Items per page, default 50, at most 100 |
| `cursor` | query | string | no | `next_cursor` of the previous page; omit for the first page |

## Example request

```bash
curl "https://api.tino.vn/service/100002/uptime/monitors" \
  -H "Authorization: Bearer $TINO_TOKEN"
```

`$TINO_TOKEN` is the Tino Uptime service owner's sign-in token. Path parameters in the example are sample values.

SDK ([SDK & examples](/en/docs/sdk)): no dedicated function yet, use `client.request("GET", "/service/@id/uptime/monitors")`.

## Example response

```json
{
 "data": {
  "data": [
   {
    "id": "3f6c2a10-8b1e-4c5d-9a7f-2e4b6c8d0a11",
    "name": "Website chính",
    "interval_s": 60,
    "locations": [
     "vn-cmc",
     "vn-vt",
     "intl"
    ],
    "enabled": true,
    "paused_until": null,
    "snoozed_until": null,
    "disabled_reason": null,
    "verified": true,
    "created_at": "2026-10-24T08:00:00+07:00",
    "settings": {
     "type": "http",
     "url": "https://example.com/",
     "method": "GET",
     "expected_status": [
      200
     ],
     "follow_redirects": true,
     "header_names": [],
     "basic_auth_set": false,
     "body_set": false
    },
    "international_critical": false,
    "state": "up",
    "state_since": "2026-10-24T09:15:00+07:00",
    "last_check_at": "2026-10-24T10:30:00+07:00",
    "last_latency_ms": 182,
    "last_error_kind": null,
    "current_incident_id": null,
    "ssl_expires_at": "2027-01-15T07:00:00+07:00",
    "domain_expires_at": null,
    "uptime_30d": 99.98
   }
  ],
  "next_cursor": null
 }
}
```

Sample built from the Tino Uptime OpenAPI (Tino relays the answer as is inside `data`); values are examples.