Get board history | StatusGator Octri Preview

4 parameters

board_idstringrequired

Board public ID

start_datestringoptional

Start date (inclusive) in YYYY-MM-DD. Defaults to 30 days ago if not provided.

end_datestringoptional

End date (exclusive) in YYYY-MM-DD. Defaults to tomorrow (includes all of today) if not provided.

monitor_idstringoptional

Optional filter to a specific monitor ID

4 status codes

200defaults to last 30 days when dates not provided

dataarray<object>optional

successbooleanoptional

401unauthorized

404board not found

422invalid date format

Error handling

A 401 is returned: unauthorized. A 404 is returned: board not found. A 422 is returned: invalid date format.

import { StatusGatorAPIUnofficialOctriFullPreview } from "statusgator-octri-preview-sdk";

const client = new StatusGatorAPIUnofficialOctriFullPreview({
  baseUrl: "https://statusgator.com/api/v3",
  auth: { bearerAuth: process.env.API_TOKEN! },
});

const result = await client.boards.getHistory({ boardId: "3fa85f64-5717-4562-b3fc-2c963f66afa6" });

{
  "data": [
    {
      "details": "We are investigating",
      "duration": 60,
      "early_warning_signal": false,
      "ended_at": "2025-09-12T13:00:00Z",
      "icon_url": "zoom.png",
      "message": "Outage in progress",
      "monitor_id": "L1hZpHOn63",
      "name": "Zoom",
      "started_at": "2025-09-12T12:00:00Z",
      "status": "down"
    }
  ],
  "success": true
}

Request

Response

Errors