hosts.txt alive-hosts.txt Working sites Register domain FAQ API Docs

Endpoints

/api/check

Description

Checks if site is up or down.

HTTP methods

GET only

Parameters

sitename - (REQUIRED) Must be either '.i2p' or '.b32.i2p' domain

Response

Status Code
Content-Type
JSON

Example

http://isitup.i2p/api/check?sitename=isitup.i2p

{
  "date": "2019-12-08 08:21:25.793635",
  "time_spent": "0:00:11.457335",
  "domain": "isitup.i2p",
  "status": "UP",
  "http_status": "200",
  "headers": {
    "Transfer-Encoding": "chunked",
    "Proxy-Connection": "close",
    "Connection": "close",
    "Date": "Sun, 08 Dec 2019 08:21:27 GMT",
    "Content-type": "text/html"
  }
}

/api/siteinfo

Description

Returns domain related info: base32, base64, addresshelper, date/time of last successfull check

HTTP methods

GET only

Parameters

sites - (REQUIRED) Must be either '.i2p' or '.b32.i2p' domains
Multiple domains can be queried. In this case split them with ;

Response

Status Code
Content-Type
JSON

Example

http://isitup.i2p/api/siteinfo?sites=isitup.i2p;identiguy.i2p;oof.i2p

{
    "date": "2020-04-01 20:41:57.964401",
    "time_spent": "0:00:00.206971",
    "domains": {
      "isitup.i2p": {
        "last_online": "2020-02-14 00:25:41",
        "base64": "AkO4iVyf~3HOWYPl~Y~dV3CrGCcqt2XqmLyNp0D58UwJuL1PdiGyRz6KM...",
        "address_helper": "http://isitup.i2p/?i2paddresshelper=AkO4iVyf~3HOW...",
        "base32": "xk6ypey2az23vtdkitjxvanlshztmjs2ekd6sp77m4obszf6ocfq.b32.i2p"
      },
      "identiguy.i2p": {
        "last_online": "2020-02-14 00:13:46",
        "base64": "EhDXPsItHi7Dfx8~~0iHPzkjiK1568wqEifARTr-ngIznwVaBmeEnSHXfL...",
        "address_helper": "http://identiguy.i2p/?i2paddresshelper=EhDXPsItHi7...",
        "base32": "3mzmrus2oron5fxptw7hw2puho3bnqmw2hqy7nw64dsrrjwdilva.b32.i2p"
      },
      "oof.i2p": "Sitename unknown"
    }
}