MIRAI STATUS
You can check the latest information, MIRAI service status and GNSS station status via this Web page or REST API (GET) directly.
It is suitable to retrieve status in this way if you are using command-line tools such as WGET, CURL and so on.
Please see as follow in detail.
BASIC SPECIFICATION
・Protocol
- Communication Protocol: HTTPS (REST API)
- Authentication: Basic authentication
- User Name and Password: "E-MAIL ADDRESS" and "PASSWORD" registered in your account information
- Communication Protocol: HTTPS (REST API)
- Authentication: Basic authentication
- User Name and Password: "E-MAIL ADDRESS" and "PASSWORD" registered in your account information
・Data Format
JSON
JSON
・Base URL
https://api.go.gnss.go.jp/v1
https://api.go.gnss.go.jp/v1
・Restrictions
Call frequency limits are applied per user.
- 10 req/min
- 2,000 req/day
If the limit is exceeded, the API returns HTTP status 429 (Too Many Requests).
Call frequency limits are applied per user.
- 10 req/min
- 2,000 req/day
If the limit is exceeded, the API returns HTTP status 429 (Too Many Requests).
1. INFORMATION FOR THIS WEBSITE
・Where it is shown
Displayed in the "Information" section after logging in to the MIRAI website. This is information about website updates, maintenance, etc.
Displayed in the "Information" section after logging in to the MIRAI website. This is information about website updates, maintenance, etc.
・How to retrieve
GET /status/information
Information as of the current time is retrieved.
GET /status/information
Information as of the current time is retrieved.
・Examples of retrieving command
- for curl
- for wget
- for curl
curl -u "<email address>":"<password>" https://api.go.gnss.go.jp/v1/status/information- for wget
wget --http-user="<email address>" --http-passwd="<password>" --auth-no-challenge https://api.go.gnss.go.jp/v1/status/information・Example of response
{
"at": "2026-05-12T10:00:00Z",
"informations": [
{
"published_at": "2026-05-11T09:00:00Z",
"message": "This website will be temporarily unavailable for approximately 30 minutes due to scheduled maintenance starting at 03:00 (UTC) on May 19, 2026. We apologize for any inconvenience and appreciate your understanding."
}
]
}2. STATUS FOR MIRAI SERVICE
・Where it is shown
Displayed in the "SERVICE STATUS" indicator (blinking update) on the MIRAI website. This is status information regarding MIRAI service availability, i.e. MIRAI REALTIME DATA service.
Displayed in the "SERVICE STATUS" indicator (blinking update) on the MIRAI website. This is status information regarding MIRAI service availability, i.e. MIRAI REALTIME DATA service.
・How to retrieve
GET /status/mirai
Query parameter "at" (optional): specify a date-time in ISO 8601 format (example: 2026-05-12T10:00:00Z). If specified, retrieves the status as of that date-time; if omitted, retrieves the status as of the current time. The status value is either "available" or "unavailable".
GET /status/mirai
Query parameter "at" (optional): specify a date-time in ISO 8601 format (example: 2026-05-12T10:00:00Z). If specified, retrieves the status as of that date-time; if omitted, retrieves the status as of the current time. The status value is either "available" or "unavailable".
・Examples of retrieving command
- for curl
- for wget
- for curl
- Without "at" parameter
curl -u "<email address>":"<password>" https://api.go.gnss.go.jp/v1/status/mirai
- With "at" parameter
curl -u "<email address>":"<password>" https://api.go.gnss.go.jp/v1/status/mirai?at=<date-time in ISO 8601 format>- for wget
- Without "at" parameter
wget --http-user="<email address>" --http-passwd="<password>" --auth-no-challenge https://api.go.gnss.go.jp/v1/status/mirai
- With "at" parameter
wget --http-user="<email address>" --http-passwd="<password>" --auth-no-challenge https://api.go.gnss.go.jp/v1/status/mirai?at=<date-time in ISO 8601 format>・Example of response
{"at": "2026-05-12T10:00:00Z", "status": "available"}3. STATUS FOR EACH GNSS STATION
・Where it is shown
Stations shown on MIRAI MAP screen can be checked via blue (available) / red (unavailable) circles on the map screen of the MIRAI website.
Stations shown on MIRAI MAP screen can be checked via blue (available) / red (unavailable) circles on the map screen of the MIRAI website.
・How to retrieve
GET /status/gnss_station
Query parameter "at" (optional). Covers only the stations shown on MIRAI MAP screen and returns the status of all stations. No information is available for stations not shown. The status value indicates whether the Ntrip (real-time delivery system) of the station is operating ("available" or "unavailable").
GET /status/gnss_station
Query parameter "at" (optional). Covers only the stations shown on MIRAI MAP screen and returns the status of all stations. No information is available for stations not shown. The status value indicates whether the Ntrip (real-time delivery system) of the station is operating ("available" or "unavailable").
・Examples of retrieving command
- for curl
- for wget
- for curl
- Without "at" parameter
curl -u "<email address>":"<password>" https://api.go.gnss.go.jp/v1/status/gnss_station
- With "at" parameter
curl -u "<email address>":"<password>" https://api.go.gnss.go.jp/v1/status/gnss_station?at=<date-time in ISO 8601 format>- for wget
- Without "at" parameter
wget --http-user="<email address>" --http-passwd="<password>" --auth-no-challenge https://api.go.gnss.go.jp/v1/status/gnss_station
- With "at" parameter
wget --http-user="<email address>" --http-passwd="<password>" --auth-no-challenge https://api.go.gnss.go.jp/v1/status/gnss_station?at=<date-time in ISO 8601 format>・Example of response
{
"at": "2026-05-12T10:00:00Z",
"stations": [
{
"site": "ISHI00JPN",
"status": "available"
}
]
}Join Us for the GNSS Database All Over the Globe