README.md

r/SpaceX API V4 Docs

Disclaimer

We are not affiliated, associated, authorized, endorsed by, or in any way officially connected with Space Exploration Technologies Inc (SpaceX), or any of its subsidiaries or its affiliates. The names SpaceX as well as related names, marks, emblems and images are registered trademarks of their respective owners.

Base URL

https://api.spacexdata.com/v4

Authentication

Authentication via api key is required for all destructive routes. This includes all create, update, and delete routes.

Authenticate by passing the header spacex-key with your api key. Protected routes return 401 without a valid key.

Pagination + Custom Queries

All /query routes support pagination, custom queries, and other output controls.

See the pagination + query guide for more details and examples.

Launch date FAQ's

• Why does the date appear wrong? - This is usually due to the way we store and display partial dates in the api. For example, a launch scheduled for 2020 July would be represented as 2020-07-01T00:00:00.000Z. In this case, the field date_precision would be set as month, meaning the date is only valid to the month level, or 2020-07

Launch date field explanations

• date_utc - UTC launch date/time in ISO 8601 format

• date_unix - UTC launch date/time as a UNIX timestamp in seconds

• date_local - Local launch time with time zone offset in ISO 8601 format

• date_precision - Gives the date precision for partial dates. Valid values are quarter, half, year, month, day, hour.

• tbd - Set as true if date is To be determined

• net - Set as true if the date is No earlier than

Caching

The api makes use of response caching via Redis for all GET requests, and POST requests on /query endpoints.

Standard cache times are as follows:

launches - 20 seconds

capsules, cores, launchpads, landpads, crew, ships, payloads - 5 minutes

dragons, rockets - 24 hours

Cache can be cleared with the following endpoint:

• 🔒 Clear cache : DELETE /admin/cache

Routes

🔒 = Requires Auth

Capsules - Schema

Detailed info for serialized dragon capsules

• Get all capsules : GET /capsules
• Get one capsule : GET /capsules/:id
• Query capsules : POST /capsules/query
• 🔒 Create a capsule : POST /capsules
• 🔒 Update a capsule : PATCH /capsules/:id
• 🔒 Delete a capsule : DELETE /capsules/:id

Company Info - Schema

Detailed info about SpaceX as a company

• Get company info : GET /company
• 🔒 Update company info : PATCH /company/:id

Cores - Schema

Detailed info for serialized first stage cores

• Get all cores : GET /cores
• Get one core : GET /cores/:id
• Query cores : POST /cores/query
• 🔒 Create a core : POST /cores
• 🔒 Update a core : PATCH /cores/:id
• 🔒 Delete a core : DELETE /cores/:id

Crew - Schema

Detailed info on dragon crew members

• Get all crew members : GET /crew
• Get one crew member : GET /crew/:id
• Query crew members : POST /crew/query
• 🔒 Create a crew member : POST /crew
• 🔒 Update a crew member : PATCH /crew/:id
• 🔒 Delete a crew member : DELETE /crew/:id

Dragons - Schema

Detailed info about dragon capsule versions

• Get all dragons : GET /dragons
• Get one dragon : GET /dragons/:id
• Query dragons : POST /dragons/query
• 🔒 Create a dragon : POST /dragons
• 🔒 Update a dragon : PATCH /dragons/:id
• 🔒 Delete a dragon : DELETE /dragons/:id

Landpads - Schema

Detailed info about landing pads and ships

• Get all landpads : GET /landpads
• Get one landpad : GET /landpads/:id
• Query landpads : POST /landpads/query
• 🔒 Create a landpad : POST /landpads
• 🔒 Update a landpad : PATCH /landpads/:id
• 🔒 Delete a landpad : DELETE /landpads/:id

Launches - Schema

Detailed info about launches

• Get past launches : GET /launches/past
• Get upcoming launches : GET /launches/upcoming
• Get latest launch : GET /launches/latest
• Get next launch : GET /launches/next
• Get all launches : GET /launches
• Get one launch : GET /launches/:id
• Query launches : POST /launches/query
• 🔒 Create a launch : POST /launches
• 🔒 Update a launch : PATCH /launches/:id
• 🔒 Delete a launch : DELETE /launches/:id

Launchpads - Schema

Detailed info about launchpads

• Get all launchpads : GET /launchpads
• Get one launchpad : GET /launchpads/:id
• Query launchpads : POST /launchpads/query
• 🔒 Create a launchpad : POST /launchpads
• 🔒 Update a launchpad : PATCH /launchpads/:id
• 🔒 Delete a launchpad : DELETE /launchpads/:id

Payloads - Schema

Detailed info about launch payloads

• Get all payloads : GET /payloads
• Get one payload : GET /payloads/:id
• Query payloads : POST /payloads/query
• 🔒 Create a payload : POST /payloads
• 🔒 Update a payload : PATCH /payloads/:id
• 🔒 Delete a payload : DELETE /payloads/:id

Fairings - Schema

Detailed info on SpaceX fairings

• Get all fairings : GET /fairings
• Get one fairing : GET /fairings/:id
• Query fairings : POST /fairings/query
• 🔒 Create a fairing : POST /fairings
• 🔒 Update a fairing : PATCH /fairings/:id
• 🔒 Delete a fairing : DELETE /fairings/:id

Roadster info - Schema

Detailed info about Elon's Tesla roadster's current position

• Get roadster info : GET /roadster
• Query roadster info : POST /roadster/query
• 🔒 Update roadster info : PATCH /roadster/:id

Rockets - Schema

Detailed info about rocket versions

• Get all rockets : GET /rockets
• Get one rocket : GET /rockets/:id
• Query rockets : POST /rockets/query
• 🔒 Create a rocket : POST /rockets
• 🔒 Update a rocket : PATCH /rockets/:id
• 🔒 Delete a rocket : DELETE /rockets/:id

Ships - Schema

Detailed info about ships in the SpaceX fleet

• Get all ships : GET /ships
• Get one ship : GET /ships/:id
• Query ships : POST /ships/query
• 🔒 Create a ship : POST /ships
• 🔒 Update a ship : PATCH /ships/:id
• 🔒 Delete a ship : DELETE /ships/:id

Starlink - Schema

Detailed info about Starlink satellites and orbits

Includes raw orbit data from Space Track, updated hourly.

Space Track data adheres to the standard for Orbit Data Messages

• Get all Starlink sats : GET /starlink
• Get one Starlink sat : GET /starlink/:id
• Query Starlink sats : POST /starlink/query
• 🔒 Create a Starlink sat : POST /starlink
• 🔒 Update a Starlink sat : PATCH /starlink/:id
• 🔒 Delete a Starlink sat : DELETE /starlink/:id

History - Schema

Detailed info on SpaceX historical events

• Get all historical events : GET /history
• Get one historical event : GET /history/:id
• Query historical events : POST /history/query
• 🔒 Create a historical event : POST /history
• 🔒 Update a historical event : PATCH /history/:id
• 🔒 Delete a historical event : DELETE /history/:id