UptimeTea

API Documentation

The UptimeTea API is easy to use and free for all plans.

List incidents

Returns all incidents for your watchers, ordered by creation date (newest first).

GET https://api.uptimetea.com/incidents

Query parameters

  • watcher_idSTRING

    Only incidents of this watcher.

Headers

  • AuthorizationREQUIREDSTRING
    Bearer $TOKEN

Response body

[
  {
    "id": "uuid",
    "watcher_id": "uuid",
    "watcher": {
      "id": "uuid",
      "title": "My Website",
      "url": "https://example.com",
      "category": "website"
    },
    "status": "open",
    "description": "Website monitor 'My Website' is down",
    "started_at": "2024-01-15T10:00:00Z",
    "acknowledged_at": null,
    "resolved_at": null,
    "duration": null,
    "comments_count": 0,
    "created_at": "2024-01-15T10:00:00Z"
  }
]

Code examples

curl -X GET "https://api.uptimetea.com/incidents" \
  -H "Authorization: Bearer $TOKEN"
// List incidents
const response = await fetch('https://api.uptimetea.com/incidents', {
  headers: {
    'Authorization': 'Bearer ' + yourToken
  }
});

const data = await response.json();
console.log(data);
# List incidents
import requests

headers = {'Authorization': f'Bearer {your_token}'}

response = requests.get(
    'https://api.uptimetea.com/incidents',
    headers=headers
)

print(response.json())
// List incidents
package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.uptimetea.com/incidents", nil)
    req.Header.Set("Authorization", "Bearer "+yourToken)

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    data, _ := io.ReadAll(resp.Body)
    fmt.Println(resp.Status, string(data))
}
# List incidents
require 'net/http'
require 'uri'

uri = URI('https://api.uptimetea.com/incidents')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Authorization'] = "Bearer #{your_token}"

response = http.request(request)
puts response.code, response.body
<?php
// List incidents
$ch = curl_init('https://api.uptimetea.com/incidents');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $yourToken
]);

$response = curl_exec($ch);
print_r(json_decode($response, true));
curl_close($ch);