https://github.com/corquaid/international-space-station-apis
JSON files containing lots of interesting information on the people currently living in space for use in your project.
https://github.com/corquaid/international-space-station-apis
api astronauts cargo cosmonauts crew docked dragon international-space-station iss nasa people-in-space roscosmos soyuz space spacecraft spaceflight spacex
Last synced: about 2 months ago
JSON representation
JSON files containing lots of interesting information on the people currently living in space for use in your project.
- Host: GitHub
- URL: https://github.com/corquaid/international-space-station-apis
- Owner: corquaid
- License: mit
- Created: 2021-01-05T14:32:54.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2026-04-04T07:05:22.000Z (about 2 months ago)
- Last Synced: 2026-04-04T09:11:36.579Z (about 2 months ago)
- Topics: api, astronauts, cargo, cosmonauts, crew, docked, dragon, international-space-station, iss, nasa, people-in-space, roscosmos, soyuz, space, spacecraft, spaceflight, spacex
- Language: CSS
- Homepage:
- Size: 2.59 MB
- Stars: 20
- Watchers: 1
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# International Space Station APIs
APIs packed with information regarding all ongoing spaceflights and spacecraft operations at the International Space Station, the Chinese Space Station (Tiangong) and other orbital and deep-space missions.
The inspiration for this project came from various space-related APIs, including [Open Notify](http://open-notify.org/) by Nathan Bergey and the excellent [Where The ISS At](https://wheretheiss.at/w/developer) resource.
It's my goal to keep these APIs up to date depending on rocket launch schedules and spacecraft docking and departures from the ISS and CSS.
I hope the level of detail in these APIs is useful for your own projects.
Please let me know if there is any information that you would like to have added to either API, just open an issue, or go ahead and create a PR!
Ad Astra!
(Please note that I won't be updating for sub-orbital spaceflights (New Shepard, Virgin Galactic and the like), only orbital and deep-space flights.)
## APIs
### People In Space :woman_astronaut:
[People In Space](https://corquaid.github.io/international-space-station-APIs/JSON/people-in-space.json) (JSON)
`https://corquaid.github.io/international-space-station-APIs/JSON/people-in-space.json`
Calling this API will return lots of information about the only humans not currently on Earth.
Here's an example of the returned JSON:
```json
{
"number": 10,
"iss_expedition": 71,
"expedition_patch": "https://upload.wikimedia.org/wikipedia/commons/b/b4/ISS_Expedition_71_Patch.png",
"expedition_url": "https://en.wikipedia.org/wiki/Expedition_71",
"expedition_image": "https://upload.wikimedia.org/wikipedia/commons/8/81/The_official_Expedition_71_crew_portrait.jpg",
"expedition_start_date": 1712354400,
"people": [
...
{
"id": 11,
"name": "Zena Cardman",
"country": "United States",
"flag_code": "us",
"agency": "NASA",
"position": "Flight Engineer",
"spacecraft": "Crew-11 Dragon",
"launched": 1754055822,
"iss": true,
"days_in_space": 0,
"url": "https://en.wikipedia.org/wiki/Zena_Cardman",
"image": "https://upload.wikimedia.org/wikipedia/commons/1/14/Zena_Cardman_2023_%28portrait_crop%29.jpg",
"instagram": "https://www.instagram.com/zenanaut",
"twitter": "https://x.com/zenanaut",
"facebook": "https://www.facebook.com/zenanaut"
},
...
]
}
```
`"flag_code"` can be used with resources like [countryflags.io](www.countryflags.io) to add national flags to your app.
`"days_in_space"` is the person's total spaceflight experience **_before_** their current mission.
`"launched"` is the start time for their current mission, measured in seconds, since the [UNIX epoch](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date).
Using `"launched"` and `"days_in_space"` together, you can calculate the up-to-date total time a person has spent above the [Karman line](https://en.wikipedia.org/wiki/K%C3%A1rm%C3%A1n_line)!
### Spacecraft at the ISS :rocket:
[ISS Docked Spacecraft](https://corquaid.github.io/international-space-station-APIs/JSON/iss-docked-spacecraft.json) (JSON)
`https://corquaid.github.io/international-space-station-APIs/JSON/iss-docked-spacecraft.json`
If you want to know all about the spacecraft currently docked at the International Space Station, this API will get you up to speed.
Here's an example of the returned JSON:
```json
{
"number": 5,
"spacecraft": [
....
{
"id": 5,
"name": "Crew-11 Dragon",
"country": "United States",
"flag_code": "us",
"operator": "SpaceX",
"manufacturer": "SpaceX",
"spacecraft_name": "Endeavour",
"launched": 1754055822,
"launch_site": "KSC, LC-39A",
"iss": true,
"docked": 1754108816,
"docking_port": "Harmony zenith",
"launch_mass": null,
"payload_mass": null,
"launch_vehicle": "Falcon 9",
"launch_vehicle_name": "B1094.3",
"mission_type": "Crew",
"crew": ["Zena Cardman", "Michael Fincke", "Kimiya Yui", "Oleg Platonov"],
"mission_patch": "https://upload.wikimedia.org/wikipedia/commons/e/ec/SpaceX_Crew-11_logo.png",
"mission_patch_2": "https://upload.wikimedia.org/wikipedia/en/5/5a/SpaceX_Crew-11_mission_patch.png",
"mission_patch_3": "https://upload.wikimedia.org/wikipedia/en/d/d2/SpaceX_Crew-11_JAXA_mission_patch.png",
"url": "https://en.wikipedia.org/wiki/SpaceX_Crew-11",
"image": "https://upload.wikimedia.org/wikipedia/commons/6/64/Crew-11_official_portrait.jpg"
}
...
]
}
```
The same calculation can be performed here where you use the `"docked"` UNIX timestamp and your current `Date()` timestamp to return the total time each spacecraft has been docked at the ISS.
This NASA resource is also useful with a nice visualisation of the docked spacecraft:
[ISS Visiting Vehicles (NASA site)](https://www.nasa.gov/international-space-station/space-station-visiting-vehicles/)
# References
[Open Notify](http://open-notify.org/) by [Nathan Bergey](http://t.co/jIv30xdyTZ?amp=1).
[Where The ISS At?](https://wheretheiss.at/) by [Bill Shupp](https://about.me/shupp).
>