Open Notify API

Beginner's Pick Science & Math / No Auth Required Beginner HTTP
Free to Use
60 C
Measured Score 0 50 100 Speed 21/30 Consistency 20/20 Security 0/20 Browser access 15/15 Transparency 4/15 TESTED 2026-08-10

Overview

Open Notify provides real-time data about the International Space Station (ISS) — including its current location, the astronauts currently aboard, and pass times over your location. No API key or sign-up is needed; just make a GET request and get live space data instantly. It is a fantastic beginner API for learning how to fetch and display real-time data from a public source.

Beginner Tip

The ISS location endpoint updates every few seconds, so you can build a real-time tracker by calling it on an interval — try polling every 5 seconds to show the ISS moving across a map.

Measurement Record

What actually happened when we called this API from our own infrastructure. Every value below was recorded by the request, not copied from the provider's documentation.

Request
GET http://api.open-notify.org/iss-now.json
Result
HTTP 200 · application/json · 114 bytes
Response time
133 ms (median of 3)
Browser CORS
Allowed — Access-Control-Allow-Origin: *
Served by
nginx/1.10.3
Recorded
2026-08-10

Fields Returned

Top-level fields present in the response we captured, with the type and value we actually received.

Field Type Value received
iss_position object {2 fields}
message string success
timestamp integer 1786391606

Captured Response

Captured from a real request to http://api.open-notify.org/iss-now.json on 2026-08-10. Long arrays and nested objects are truncated to keep the shape readable.

JSON Response · Captured
{
  "iss_position": {
    "longitude": "-37.7901",
    "latitude": "-13.3504"
  },
  "message": "success",
  "timestamp": 1786391606
}

Field Reference

iss_position Contains the current latitude and longitude of the ISS as decimal degree strings.
latitude Current latitude of the ISS in decimal degrees (inside the iss_position object).
longitude Current longitude of the ISS in decimal degrees (inside the iss_position object).
timestamp Unix timestamp (seconds since epoch) indicating when this position was recorded.
message Status of the request — "success" if the data was retrieved correctly.

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request
const url = "http://api.open-notify.org/iss-now.json";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

How This API Fails

We deliberately sent this API a broken request and recorded exactly what came back on 2026-08-10. Knowing the shape of an error before you hit it makes error handling much easier to write.

HTTP 404 Requesting a path that does not exist application/json

Returned an HTML error page rather than JSON — worth knowing if your client assumes every response can be parsed as JSON.

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

HTTP blocked in browser or HTTPS app Open Notify uses HTTP (not HTTPS), which modern browsers and some frameworks block by default.
Call the API from your backend server (Node.js, Python, etc.) and relay the data to your frontend to avoid mixed-content issues.
"status": "failure" on pass times endpoint The latitude or longitude parameters are missing or out of valid range.
The /iss-pass.json endpoint requires lat (-90 to 90) and lon (-180 to 180) query parameters — e.g., ?lat=40.7&lon=-74.0.
Stale or cached location data Your HTTP client or server is caching the response and not fetching fresh data.
Add Cache-Control: no-cache to your request headers, or append a unique query string like ?t=Date.now() to bust the cache.

Measured Score Breakdown

Live HTTP request to the API endpoint

Speed 21/30
Consistency 20/20
Security 0/20
Browser access 15/15
Transparency 4/15
Endpoint Response Time 133ms

Fully tested on Aug 10, 2026

Technical Specifications

Auth No Auth
HTTPS NO
CORS NO
Category Science & Math
Difficulty Beginner
Endpoint last called: 2026-08-10

Related Tags

Similar APIs

View All →