List websites' uptime

GET

https://api.modulards.com/api/public/v1/uptime

GET

/api/public/v1/uptime

curl https://api.modulards.com/api/public/v1/uptime \
     -H "Authorization: Bearer <token>"

200200 - Uptime portfolio, one website down

{
  "data": [
    {
      "attributes": {
        "enabled": true,
        "last_ping": {
          "at": "2026-02-10T11:00:00.000000Z",
          "error": "Server error",
          "response_time_ms": null,
          "status": "down",
          "status_code": 503
        },
        "site": {
          "id": 1,
          "name": "Portfolio site"
        },
        "status": "down",
        "status_since": "2026-02-10T11:00:00.000000Z"
      },
      "id": "1",
      "links": {
        "self": "{{base_url}}/api/public/v1/uptime-services/1"
      },
      "type": "site-uptimes"
    },
    {
      "attributes": {
        "enabled": true,
        "last_ping": {
          "at": "2026-09-21T10:00:00.000000Z",
          "error": null,
          "response_time_ms": 312,
          "status": "up",
          "status_code": 200
        },
        "site": {
          "id": 5,
          "name": "Marketing site"
        },
        "status": "up",
        "status_since": "2026-08-01T06:00:00.000000Z"
      },
      "id": "2",
      "links": {
        "self": "{{base_url}}/api/public/v1/uptime-services/2"
      },
      "type": "site-uptimes"
    }
  ],
  "jsonapi": {
    "version": "1.1"
  },
  "links": {
    "first": "{{base_url}}/api/public/v1/uptime?page%5Bnumber%5D=1",
    "last": "{{base_url}}/api/public/v1/uptime?page%5Bnumber%5D=1",
    "next": null,
    "prev": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "active": false,
        "label": "&laquo; Previous",
        "url": null
      },
      {
        "active": true,
        "label": "1",
        "url": "{{base_url}}/api/public/v1/uptime?page%5Bnumber%5D=1"
      },
      {
        "active": false,
        "label": "Next &raquo;",
        "url": null
      }
    ],
    "path": "{{base_url}}/api/public/v1/uptime",
    "per_page": 15,
    "to": 2,
    "total": 2
  }
}

Lists the current uptime status of your monitored websites, one row per website, so a single call answers “is anything down right now?”. Each row shows whether the monitor is on, the website’s status (up, down or unknown), since when it has had that status and its last ping. last_ping is null when the monitor has not pinged in the last 30 days.

Outages come first by default. The rolling availability of one website is in “Retrieve a website’s uptime”.

Your role must be allowed to read uptime; without it the request answers 404.

Authentication

AuthorizationBearer

Personal access token created in the Modular DS dashboard; read-only tokens can only call GET endpoints.

Query parameters

filter[site][]stringOptional

Exact website ids. Repeat the parameter for several: any of them matches.

filter[status][]stringOptional

The website's current status: up, down or unknown. Repeat the parameter for several: any of them matches.

filter[service_status][]stringOptional

Whether the monitor is on: enabled or disabled. Repeat the parameter for several.

filter[s]stringOptional

Free-text search over the website name, slug or URL (max 255 characters).

sortstringOptional

status or site_name; prefix with - for descending. Default: -status (outages first).

page[number]stringOptional

Page number, starting at 1. Default 1.

page[size]stringOptional

Items per page, 1 to 50. Default 15.

Response

200 - Uptime portfolio, one website down

datalist of objectsOptional

jsonapiobjectOptional

linksobjectOptional

metaobjectOptional