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.
{
"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.
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.
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.
Measured Score Breakdown
Live HTTP request to the API endpoint
Fully tested on Aug 10, 2026
Technical Specifications
Related Tags
Similar APIs
View All →arcsecond.io
⭐ Beginner's Pickarcsecond.io is a free astronomy API that aggregates data from multiple space databases, including stars, planets, exoplanets, and observing sites.
GBIF
⭐ Beginner's PickGBIF (Global Biodiversity Information Facility) is a free, open API providing access to hundreds of millions of species occurrence records from around the world.
iDigBio
iDigBio is a free API that gives you access to millions of digitized natural history museum specimens from institutions across the United States and beyond.
inspirehep.net
INSPIRE-HEP is a free REST API for the High Energy Physics literature database, covering papers, authors, institutions, conferences, and experiments in particle physics.
ISRO
⭐ Beginner's PickISRO is a free, no-auth API that provides detailed information about the Indian Space Research Organisation spacecraft and missions.