Launch Library Reading API Overview Calls All API calls should be made with HTTP GET.

Request data is passed in one of two ways:

1. An ID or name can be passed in via the URL line. For example /launch/5 or launch/Falcon.

2. Via URL Parameters, as listed below.

1. An ID or name can be passed in via the URL line. For example /launch/5 or launch/Falcon. 2. Via URL Parameters, as listed below. Many URL Parameters can be repeated to provide a list. For example /launch?id=4&id=9

Text searching is case insensitive.

Omitting parameters for each type will usually return a list of 10 objects, but not always. Sometimes it will be more (or all in the case of types), sometimes it will error and tell you what is necessary.

Getting 403s? You might need to make sure you are passing in proper headers, such as an accept header and acceptable user agent. Rule of thumb is that if a url is working in a browser, but not your application, you may need to modify your request to make it work.

Returns

All returns are JSON objects with various options. The data on non-failure will be variable depending on your options. Failures will contain a status variable and a msg variable: Failure Name Description status "fail" msg A probably less than helpful error message. Wrappers You can use one of these wrappers to help you along your way. Please note that these wrappers are not written, fully evaluated, or controlled by the Launch Library. Use at your own risk. Language URL Python https://github.com/Plutoberth/python-launch-library Back to Top Agency * Launch Service Providers are agencies with the islsp flag set to 1. As noted below, there is a shortcut to just pull them. Usage: https://launchlibrary.net/1.4/agency Usage shortcut for LSPs only: https://launchlibrary.net/1.4/lsp Examples: To return the agency with an ID of 5:

https://launchlibrary.net/1.4/agency/5 OR https://launchlibrary.net/1.4/agency?id=5

To return the agency with an abbreviation of NASA:

https://launchlibrary.net/1.4/agency/NASA OR https://launchlibrary.net/1.4/agency?abbrev=nasa

NOTE: Agencies match here against abbreviation, not name.

To return the agency with a name matching "National":

https://launchlibrary.net/1.4/agency?name=National All Parameters: Name Description mode How much you want returned. Either list, summary, or verbose. id The id of a specific agency you want. name The name of a specific agency you want. abbrev The abbreviaton of the agency you want. type The agency type id for the agency you are looking for. countryCode The three letter country code the agency's country of origin. islsp Whether or not this agency is a Launch Service Provider. changed Changed on or after the supplied date Returned Properties: Name Type mode(s) id Integer L S V name String L S V abbrev String L S V type Integer S V countryCode String S V wikiURL String V infoURL* String V infoURLs Array of strings V islsp Integer (0 for no, 1 for yes) V changed String (date) V *The property infoURL is being depricated and will be removed in future releases, please switch your applications to using infoURLs Back to Top Agency Type Usage: https://launchlibrary.net/1.4/agencytype Examples: To return the agency type with an ID of 1:

https://launchlibrary.net/1.4/agencytype/1 OR https://launchlibrary.net/1.4/agencytype?id=1

To return the agency type with a name of government:

https://launchlibrary.net/1.4/agencytype/Government OR https://launchlibrary.net/1.4/agencytype?name=Government All Parameters: Name Description name Name for the agency type. id ID for the agency type. changed Changed on or after the supplied date Returned Properties: Name Type id Integer L S V name String L S V changed String (date) V Back to Top Event Type Usage: https://launchlibrary.net/1.4/eventtype Examples: To return the event type with an ID of 1:

https://launchlibrary.net/1.4/eventtype/1 OR https://launchlibrary.net/1.4/eventtype?id=1

To return the event type with a name of info:

https://launchlibrary.net/1.4/eventtype/info OR https://launchlibrary.net/1.4/eventtype?name=info All Parameters: Name Description name Name for the agency type. id ID for the agency type. changed Changed on or after the supplied date Returned Properties: Name Type id Integer L S V name String L S V changed String (date) V Back to Top Launch Usage: https://launchlibrary.net/1.4/launch Note: /calendar is an alias for /launch and sets format=ics for you. Examples: To return the launch with an ID of 1:

https://launchlibrary.net/1.4/launch/120 OR https://launchlibrary.net/1.4/launch?id=120

To return the launch with a name including Falcon:

https://launchlibrary.net/1.4/launch/Falcon OR https://launchlibrary.net/1.4/launch?name=falcon

To return the next 5 launches:

https://launchlibrary.net/1.4/launch/next/5 OR https://launchlibrary.net/1.4/launch?next=5

To return launches between August 20th, 2015 and September 20th, 2015:

https://launchlibrary.net/1.4/launch/2015-08-20/2015-09-20 OR https://launchlibrary.net/1.4/launch?startdate=2015-08-20&enddate=2015-09-20

To return launches after August 20th, 2015:

https://launchlibrary.net/1.4/launch/2015-08-20 OR https://launchlibrary.net/1.4/launch?startdate=2015-08-20

To return the launch with the id of 20 and the fields name and location id only:

https://launchlibrary.net/1.4/launch/20?fields=name,locationid OR https://launchlibrary.net/1.4/launch?id=20&fields=name,locationid

To return the launch with the id of 20 in ICS format:

https://launchlibrary.net/1.4/launch/20?format=ics OR https://launchlibrary.net/1.4/calendar/20 Note: The total in the response is the total number of launches meeting your criteria, to be used with paging. You can get the next page by changing your offset. All Parameters: Name Description mode Modes are list, summary, verbose. sort Sorts by NET. Use asc for ascending, desc for descending. Defaults to ascending. format Format of the response. Possible formats are json and ics, defaults to json.

If there is an error or no launches match your criteria, it will respond with a 404 and a json body. seq Used only when format=ics. Pass in a sequence number. If it is greater than 0 and they have the event on their calendar, it should update the existing instead of creating a new.

Search Options



If all of the following are omitted, it will return the next 10 launches by default.

next Return the next N launches startdate Date/Time to start search for. If this an enddate Date/Time for the next launch attempt. limit Limit of responses. Defaults to 10. offset Offset, for pagination. id The ID of the launch you are searching for. name The ID of the launch you are searching for. locationid The LocationID for the launch you are searching for. rocketid The RocketID for the launch you are searching for. lsp The Launch Service Provider (LSP) agency for the launch changed Changed on or after the supplied date Returned Properties: Name Type mode(s) Top Level offset Integer (used in paging) L S V count Integer (used in paging) L V total Integer (used in paging) L S V Launch Objects in Array id Integer L S V name String L S V net String (formatted as Month, dd, yyyy hh24:mi:ss UTC) L S V tbddate Integer (If it's a 1, we're not 100% on the date) L S V tbdtime Integer (If it's a 1, we're not 100% on the time) L S V status Integer (1 Green, 2 Red, 3 Success, 4 Failed) S V inhold Integer (deprecated, use status) S V windowstart String (formatted as Month, dd, yyyy hh24:mi:ss UTC) S V windowend String (formatted as Month, dd, yyyy hh24:mi:ss UTC) V isostart String (formatted as yyyymmddThh24missZ) V isoend String (formatted as yyyymmddThh24missZ) V isonet String (formatted as yyyymmddThh24missZ) V wsstamp Integer (Unix timestamp) V westamp Integer (Unix timestamp) V netstamp Integer (Unix timestamp) V infoURL * String V vidURL * String V infoURLs Array of strings V vidURLs Array of strings V holdreason String V failreason String V probability Integer (will be -1 if unkown to us) V hashtag String V lsp Integer V changed String (date) V location + An object containing an array of pad objects V rocket + Object containing rocket properties V missions + Array containing mission objects V Back to Top * The properties infoURL and vidURL are being depricated and will be removed in future releases, please switch your applications to using infoURLs and vidURLs + The various objects returned may not have all of the properties of the verbose objects in their calls. Launch Event Usage: https://launchlibrary.net/1.4/launchevent Examples: To return the launch event with an ID of 7:

https://launchlibrary.net/1.4/launchevent/7 OR https://launchlibrary.net/1.4/launchevent?id=7

To return the launch event with a launch id of 12:

https://launchlibrary.net/1.4/launchevent?parentid=12 All Parameters: Name Description mode Modes are: list, summary, verbose id ID for the launch event. name Name of launch event type Event type. parentid ID of launch. changed Changed on or after the supplied date Returned Properties: Name Type mode(s) id Integer L S V name String L S V relativeTime Integer (time in seconds to/from T-0) L S V type Integer S V duration Integer S V description String V parentid Integer V changed String (date) V Back to Top Launch Status Usage: https://launchlibrary.net/1.4/launchstatus Examples: To return the launc status with an ID of 1:

https://launchlibrary.net/1.4/launchstatus/1 OR https://launchlibrary.net/1.4/launchstatus?id=1

To return the launch status with a name of GREEN:

https://launchlibrary.net/1.4/launchstatus/green OR https://launchlibrary.net/1.4/launch?name=green All Parameters: Name Description name Name for the launch status. id ID for the launch status. changed Changed on or after the supplied date Returned Properties: Name Type mode(s) id Integer L S V name String L S V description String L S V changed String (date) V Back to Top Location Usage: https://launchlibrary.net/1.4/location Examples: To return the location with an ID of 1:

https://launchlibrary.net/1.4/location/1 OR https://launchlibrary.net/1.4/location?id=1

To return the location with a name of Woomera:

https://launchlibrary.net/1.4/location/woomera OR https://launchlibrary.net/1.4/location?name=woomera

To return the location withing the United States:

https://launchlibrary.net/1.4/location?countryCode=USA All Parameters: Name Description mode Modes are list, summary, verbose countrycode ISO 3-letter country code for primary country of the location. id ID of the location. name Name of the location. changed Changed on or after the supplied date Returned Properties: Name Type mode(s) id Integer L S V name String L S V countrycode String L S V wikiURL String V infoURL * String V infoURLs Array of strings V changed String (date) V Back to Top Mission Usage: https://launchlibrary.net/1.4/mission Examples: To return the mission with an ID of 42:

https://launchlibrary.net/1.4/mission/42 OR https://launchlibrary.net/1.4/mission?id=42

To return the mission with a name of GPS:

https://launchlibrary.net/1.4/mission/GPS OR https://launchlibrary.net/1.4/mission?name=GPS

To return the mission with a launch ID of 12:

https://launchlibrary.net/1.4/launch?launchid=12 All Parameters: Name Description mode Modes are overview, summary, verbose. fields An array of strings for fields returned in summary or verbose. The ID, name, net, inhold, and status fields are returned in summary if this is not present. All fields are returned in verbose if this is not present.

Search Options



If all of the following are omitted, it will return the first 10 missions returned by the db by default.

limit Limit of responses. Defaults to 10. offset Offset, for pagination. id The ID of the mission you are searching for. name The ID of the mission you are searching for. description The description of the mission you are searching for. launchid The ID of the launch the mission is attached to. type The type of mission. agency An agency involved in the mission. changed Changed on or after the supplied date Returned Properties: Name Type mode(s) id Integer L S V name String L S V description String S V launch Integer V type Integer V wikiURL String V infoURL * String V changed String (date) V infoURLs Array of strings V agencies array of agencies V events array of mission events V payloads array of payloads V Back to Top Mission Event Usage: https://launchlibrary.net/1.4/missionevent Examples: To return the mission event with an ID of 3:

https://launchlibrary.net/1.4/missionevent/3 OR https://launchlibrary.net/1.4/missionevent?id=3

To return the mission event with a mission id of 120:

https://launchlibrary.net/1.4/missionevent?parentid=120 All Parameters: Name Description mode Modes are: list, summary, verbose id ID for the mission event. name Name of mission event type Event type. parentid ID of mission. changed Changed on or after the supplied date Returned Properties: Name Type mode(s) id Integer L S V name String L S V relativeTime Integer (time in seconds to/from T-0) L S V type Integer S V duration Integer S V description String V parentid Integer V changed String (date) V Back to Top Mission Type Usage: https://launchlibrary.net/1.4/missiontype Examples: To return the mission type with an ID of 1:

https://launchlibrary.net/1.4/missiontype/1 OR https://launchlibrary.net/1.4/missiontype?id=1

To return the mission type with a name of planetary:

https://launchlibrary.net/1.4/missiontype/planetary OR https://launchlibrary.net/1.4/missiontype?name=planetary All Parameters: Name Description name Name for the mission type. description A description for the mission type. Returned Properties: Name Type id Integer name String changed String (date) Back to Top Pad Usage: https://launchlibrary.net/1.4/pad Examples: To return the pad with an ID of 1:

https://launchlibrary.net/1.4/pad/1 OR https://launchlibrary.net/1.4/pad?id=1

To return pads with a name containing launch complex:

https://launchlibrary.net/1.4/pad/launch%20complex OR https://launchlibrary.net/1.4/pad?name=launch%20complex

To return pads with a location ID of 5:

https://launchlibrary.net/1.4/pad?locationid=5 All Parameters: Name Description mode Modes are: list, summary, verbose id The ID of the pad. name Name for the pad. locationid The ID of the location for the pad. changed Changed on or after the supplied date Returned Properties: Name Type mode(s) id Integer L S V name String L S V padType Integer (0 for launch, 1 for landing) S V latitude String S V longitude String S V mapURL String V retired Integer V locationid Integer V agencies Array of agencies V wikiURL String V infoURL * String V infoURLs Array of strings V changed String (date) V Back to Top Payload Payloads are special objects only returned in missions as an array of objects. There is no endpoint currently. Properties: Name Type id Integer name String countryCodes String, comma delimited description String type Integer dimensions String(in meters) weight String (in kg) total Integer missionId String changed String (date) Back to Top Rocket Usage: https://launchlibrary.net/1.4/rocket Examples: To return the rocket with an ID of 1:

https://launchlibrary.net/1.4/rocket/1 OR https://launchlibrary.net/1.4/rocket?id=1

To return the rocket with a name containing Falcon:

https://launchlibrary.net/1.4/rocket/falcon OR https://launchlibrary.net/1.4/rocket?name=falcon

To return the rockets with configuration containing v1.4:

https://launchlibrary.net/1.4/rocket?name=v1.4 All Parameters: Name Description mode Modes are list, summary, verbose. id ID for the rocket. name Name for the rocket. configuration Configuration text for the rocket familyID The ID for the rocket family. changed Changed on or after the supplied date Name Type mode(s) id Integer L S V name String L S V defaultPads String (comma delimited integers) L S V family Object of rocket family S V wikiURL String V infoURL * String V changed String (date) V infoURLs Array of strings V imageURL + String V imageSizes ++ Array of integers V + We now host rocket images. All images are either public domain, or permission has been obtained for use by those using the Launch Library. Please set these images to cache, and do not pull them every time. They are saved with different widths, maintaining the aspect ratio of the original image. The url returned in imageURL is the largest image available for that rocket. ++ If you wish to pull a smaller image, select one of the widths from imageSizes, and replace it with the width in imageURl Back to Top Rocket Event Usage: https://launchlibrary.net/1.4/rocketevent Examples: To return the rocket event with an ID of 10:

https://launchlibrary.net/1.4/rocketevent/10 OR https://launchlibrary.net/1.4/rocketevent?id=10

To return the launch event with a launch id of 1 :

https://launchlibrary.net/1.4/rocketevent?parentid=1 Note: Rocket Events are for individual rockets only, and are copied to launch events when a rocket is assigned to a launch. All Parameters: Name Description mode Modes are: list, summary, verbose id ID for the rocket event. name Name of rocket event type Event type. parentid ID of rocket. changed Changed on or after the supplied date Returned Properties: Name Type mode(s) id Integer L S V name String L S V relativeTime Integer (time in seconds to/from T-0) L S V type Integer S V duration Integer S V description String V parentid Integer V changed String (date) V Back to Top Rocket Family Usage: https://launchlibrary.net/1.4/rocketfamily Examples: To return the rocket family with an ID of 1:

https://launchlibrary.net/1.4/rocketfamily/1 OR https://launchlibrary.net/1.4/rocketfamily?id=1 All Parameters: Name Description name Name for the rocket family. agencies Any agencies for the rocket family. changed Changed on or after the supplied date Returned Properties: Name Type mode(s) id Integer L S V name String L S V agencies Array of agencies V changed String (date) V Back to Top ChangeLog 1.4 Added payloads array to missions:

Payloads are a child array of objects in missions. The purpose is to provide more information about the satellites, telescopes, rovers, probes, crew and the like for each mission. Properties include name, description, country codes, agencies, dimensions weight, number of payload type (an example would be a crew of 7, or many cubesats), and type. This is brand new, so it will take some time for data to be collected and entered, especially for historical launches, so don't worry if something seems missing - we're on it.

Payloads are a child array of objects in missions. The purpose is to provide more information about the satellites, telescopes, rovers, probes, crew and the like for each mission. Properties include name, description, country codes, agencies, dimensions weight, number of payload type (an example would be a crew of 7, or many cubesats), and type. This is brand new, so it will take some time for data to be collected and entered, especially for historical launches, so don't worry if something seems missing - we're on it. Added change property to all objects:

The changed property is the date/time of the object's last change in the library. You can use this to get just the changes since your last sync. The initial changed data will be set to 2017-02-21 00:00:00, so no previous date changes will be available. Back to Top