Agency Instance
Modes
Levels of detail in the response - list, normal, detailed
Example - /agencies/?mode=list
Filters
Parameters - abbrev, abbrev__contains, attempted_landings, attempted_landings__gt, attempted_landings__gte, attempted_landings__lt, attempted_landings__lte, consecutive_successful_landings, consecutive_successful_landings__gt, consecutive_successful_landings__gte, consecutive_successful_landings__lt, consecutive_successful_landings__lte, consecutive_successful_launches, consecutive_successful_launches__gt, consecutive_successful_launches__gte, consecutive_successful_launches__lt, consecutive_successful_launches__lte, country_code, description, description__contains, failed_landings, failed_landings__gt, failed_landings__gte, failed_landings__lt, failed_landings__lte, failed_launches, failed_launches__gt, failed_launches__gte, failed_launches__lt, failed_launches__lte, featured, founding_year, founding_year__gt, founding_year__gte, founding_year__lt, founding_year__lte, id, name, name__contains, parent__id, pending_launches, pending_launches__gt, pending_launches__gte, pending_launches__lt, pending_launches__lte, spacecraft, successful_landings, successful_landings__gt, successful_landings__gte, successful_landings__lt, successful_landings__lte, successful_launches, successful_launches__gt, successful_launches__gte, successful_launches__lt, successful_launches__lte, total_launch_count, total_launch_count__gt, total_launch_count__gte, total_launch_count__lt, total_launch_count__lte, type__id
Example - /agencies/?abbrev=NASA
Search
Fields searched - abbrev, name
Example - /agencies/?search=SpaceX
Ordering
Fields - attempted_landings, consecutive_successful_landings, consecutive_successful_launches, failed_landings, failed_launches, featured, id, name, pending_launches, successful_landings, successful_launches, total_launch_count
Example - /agencies/?ordering=-total_launch_count
Number of results
Use limit to control the number of objects in the response (max 100)
Example - /agencies/?limit=2
Format
Switch to JSON output - /agencies/?format=json
Help
Find all the FAQs and support links on the documentation homepage - ll.thespacedevs.com/docs
GET /2.3.0/agencies/161/?format=api
{ "response_mode": "detailed", "id": 161, "url": "https://ll.thespacedevs.com/2.3.0/agencies/161/?format=api", "name": "United States Air Force", "abbrev": "USAF", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": "The United States Air Force (USAF) is the air service branch of the United States Armed Forces, and is one of the eight uniformed services of the United States. Originally created on 1 August 1907, as a part of the United States Army Signal Corps, the USAF was established as a separate branch of the United States Armed Forces in 1947 with the enactment of the National Security Act of 1947.", "administrator": "Commander-in-Chief: President of the US", "founding_year": 1947, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 193, "name": "[AUTO] United States Air Force - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_logo_20230804084626.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185152.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 99, "name": "[AUTO] United States Air Force - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_nation_20230804085132.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184855.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 1078, "consecutive_successful_launches": 68, "successful_launches": 972, "failed_launches": 106, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "https://www.af.mil", "wiki_url": "https://en.wikipedia.org/wiki/United_States_Air_Force", "social_media_links": [], "launcher_list": [ { "response_mode": "detailed", "id": 183, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/183/?format=api", "name": "Atlas Agena B", "families": [ { "response_mode": "detailed", "id": 66, "name": "Atlas", "manufacturer": [ { "response_mode": "normal", "id": 82, "url": "https://ll.thespacedevs.com/2.3.0/agencies/82/?format=api", "name": "Lockheed Martin", "abbrev": "LMT", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": "Lockheed Martin's Space Division started in the production of missiles and later ICBM's in the 1950s. Their TITAN missile system was used for 12 Gemini spacecraft and the Voyager probes. They have worked largely in collaboration with NASA on many of their probes, landers, and spacecraft, and hope to play a key role in NASA's return to the moon in 2024.", "administrator": null, "founding_year": 1953, "launchers": "Titan | Agena", "spacecraft": "Hubble | JUNO | InSight", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 80, "consecutive_successful_launches": 38, "successful_launches": 77, "failed_launches": 3, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "https://www.lockheedmartin.com/", "wiki_url": "https://en.wikipedia.org/wiki/Lockheed_Martin", "social_media_links": [] }, { "response_mode": "normal", "id": 124, "url": "https://ll.thespacedevs.com/2.3.0/agencies/124/?format=api", "name": "United Launch Alliance", "abbrev": "ULA", "type": { "id": 3, "name": "Commercial" }, "featured": true, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "Interim CEO: John Elbon", "founding_year": 2006, "launchers": "Atlas | Delta | Vulcan", "spacecraft": "", "parent": null, "image": { "id": 30, "name": "[AUTO] United Launch Alliance - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184706.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 191, "name": "[AUTO] United Launch Alliance - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185148.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 97, "name": "[AUTO] United Launch Alliance - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184852.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 173, "consecutive_successful_launches": 173, "successful_launches": 173, "failed_launches": 0, "pending_launches": 38, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "https://www.ulalaunch.com/", "wiki_url": "https://en.wikipedia.org/wiki/United_Launch_Alliance", "social_media_links": [] } ], "parent": null, "description": "", "active": true, "maiden_flight": "1958-12-18", "total_launch_count": 442, "consecutive_successful_launches": 184, "successful_launches": 405, "failed_launches": 37, "pending_launches": 8, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Atlas LV-3 Agena B", "variant": "LV-3 Agena B", "active": false, "is_placeholder": false, "program": [], "reusable": false, "image": { "id": 2533, "name": "Atlas-LV3 Agena-B", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas-lv3_agena_image_20251111092848.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas-lv3_agena_image_thumbnail_20251111092848.png", "credit": "NASA", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "info_url": "https://www.astronautix.com/a/atlasagenalv-3a.html", "wiki_url": null, "description": "The Atlas LV-3A was a largely unsuccessful configuration until it was given an Agena B upper stage. It was responsible for the launch of Mariner II to Venus and had one of the first engines that could be restarted in orbit.", "alias": "", "min_stage": null, "max_stage": null, "length": 20.27, "diameter": 3.05, "maiden_flight": "1961-01-31", "launch_cost": 14210000, "launch_mass": 130.0, "leo_capacity": null, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 363.0, "apogee": null, "total_launch_count": 29, "consecutive_successful_launches": 6, "successful_launches": 21, "failed_launches": 8, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P2DT22H6M8S" }, { "response_mode": "detailed", "id": 189, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/189/?format=api", "name": "Delta DM-19", "families": [ { "response_mode": "detailed", "id": 73, "name": "Thor", "manufacturer": [ { "response_mode": "normal", "id": 153, "url": "https://ll.thespacedevs.com/2.3.0/agencies/153/?format=api", "name": "McDonnell Douglas", "abbrev": "MDC", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/McDonnell_Douglas", "social_media_links": [] } ], "parent": null, "description": "", "active": false, "maiden_flight": "1958-08-17", "total_launch_count": 330, "consecutive_successful_launches": 0, "successful_launches": 285, "failed_launches": 45, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Thor-Delta", "variant": "DM-19", "active": false, "is_placeholder": false, "program": [], "reusable": false, "image": null, "info_url": "http://www.astronautix.com/t/thordm-19.html", "wiki_url": null, "description": "The Delta DM-19, or Thor-Delta was an early launch system used for 12 launches in the early '60s in the US. The first stage was a Thor missile with the second stage being the Delta, hence the name Thor-Delta. Of 12 flights, it failed only once and put 11 satellites into orbit between 1960 and 62.", "alias": "", "min_stage": 3, "max_stage": 3, "length": 18.42, "diameter": 2.44, "maiden_flight": "1960-05-13", "launch_cost": 4930000, "launch_mass": 54.0, "leo_capacity": null, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 759.0, "apogee": null, "total_launch_count": 3, "consecutive_successful_launches": 3, "successful_launches": 3, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P34DT16H55M59S" }, { "response_mode": "detailed", "id": 187, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/187/?format=api", "name": "Thor DM-21 Ablestar", "families": [ { "response_mode": "detailed", "id": 73, "name": "Thor", "manufacturer": [ { "response_mode": "normal", "id": 153, "url": "https://ll.thespacedevs.com/2.3.0/agencies/153/?format=api", "name": "McDonnell Douglas", "abbrev": "MDC", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/McDonnell_Douglas", "social_media_links": [] } ], "parent": null, "description": "", "active": false, "maiden_flight": "1958-08-17", "total_launch_count": 330, "consecutive_successful_launches": 0, "successful_launches": 285, "failed_launches": 45, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Thor DM-21 Ablestar", "variant": "DM-21", "active": false, "is_placeholder": false, "program": [], "reusable": false, "image": { "id": 1852, "name": "[AUTO] Thor DM-21 Ablestar - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/thor2520dm-212520ablestar_image_20191201205131.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193935.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Thor-Ablestar", "description": "The Thor-Ablestar, or Thor Able-Star, also known as Thor-Epsilon was an early American expendable launch system consisting of a PGM-17 Thor missile, with an Ablestar upper stage. It was a member of the Thor family of rockets, and was derived from the Thor-Able.", "alias": "", "min_stage": 2, "max_stage": 2, "length": 29.0, "diameter": 1.44, "maiden_flight": "1960-04-13", "launch_cost": null, "launch_mass": 51.0, "leo_capacity": 150.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 760.0, "apogee": null, "total_launch_count": 19, "consecutive_successful_launches": 5, "successful_launches": 13, "failed_launches": 6, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P46DT21H52M" }, { "response_mode": "detailed", "id": 186, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/186/?format=api", "name": "Thor DM-21 Agena-B", "families": [ { "response_mode": "detailed", "id": 73, "name": "Thor", "manufacturer": [ { "response_mode": "normal", "id": 153, "url": "https://ll.thespacedevs.com/2.3.0/agencies/153/?format=api", "name": "McDonnell Douglas", "abbrev": "MDC", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/McDonnell_Douglas", "social_media_links": [] } ], "parent": null, "description": "", "active": false, "maiden_flight": "1958-08-17", "total_launch_count": 330, "consecutive_successful_launches": 0, "successful_launches": 285, "failed_launches": 45, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, { "response_mode": "detailed", "id": 193, "name": "Thor-Agena", "manufacturer": [ { "response_mode": "normal", "id": 153, "url": "https://ll.thespacedevs.com/2.3.0/agencies/153/?format=api", "name": "McDonnell Douglas", "abbrev": "MDC", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/McDonnell_Douglas", "social_media_links": [] } ], "parent": { "response_mode": "normal", "id": 73, "name": "Thor", "manufacturer": [ { "response_mode": "normal", "id": 153, "url": "https://ll.thespacedevs.com/2.3.0/agencies/153/?format=api", "name": "McDonnell Douglas", "abbrev": "MDC", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null } ], "parent": null }, "description": "", "active": false, "maiden_flight": "1959-02-28", "total_launch_count": 142, "consecutive_successful_launches": 13, "successful_launches": 120, "failed_launches": 22, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Thor DM-21 Agena-B", "variant": "", "active": false, "is_placeholder": false, "program": [], "reusable": false, "image": { "id": 1853, "name": "Thor-DM21 Agena-B (KH-3 6)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/thor-dm21_agena_image_20251112153059.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/thor-dm21_agena_image_thumbnail_20251112153059.png", "credit": "USAF", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Thor-Agena", "description": "Thor-Agena was a series of orbital launch vehicles.", "alias": "", "min_stage": null, "max_stage": null, "length": null, "diameter": null, "maiden_flight": "1960-10-26", "launch_cost": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": null, "apogee": null, "total_launch_count": 40, "consecutive_successful_launches": 18, "successful_launches": 32, "failed_launches": 8, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P1DT2H32M56S" } ], "spacecraft_list": [] }
