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 - lldev.thespacedevs.com/docs
GET /2.3.0/agencies/34/?format=api
{ "response_mode": "detailed", "id": 34, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/34/?format=api", "name": "Iranian Space Agency", "abbrev": "ISA", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 32, "name": "Iran", "alpha_2_code": "IR", "alpha_3_code": "IRN", "nationality_name": "Iranian", "nationality_name_composed": "Irano" } ], "description": "The Iranian Space Agency is Iran's governmental space agency. Iran became an orbital-launch-capable nation in 2009. Iran is one of the 24 founding members of the United Nations Committee on the Peaceful Uses of Outer Space, which was set up in 1958.", "administrator": "Administrator: Hassan Salarieh", "founding_year": 2004, "launchers": "Safir | Simorgh", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 145, "name": "[AUTO] Iranian Space Agency - logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/iranian2520space2520agency_logo_20200422091550.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185013.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": null, "total_launch_count": 15, "consecutive_successful_launches": 2, "successful_launches": 6, "failed_launches": 9, "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.isa.ir/", "wiki_url": "https://en.wikipedia.org/wiki/Iranian_Space_Agency", "social_media_links": [], "launcher_list": [ { "response_mode": "detailed", "id": 39, "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/39/?format=api", "name": "Safir", "families": [ { "response_mode": "detailed", "id": 136, "name": "Nodong", "manufacturer": [ { "response_mode": "normal", "id": 34, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/34/?format=api", "name": "Iranian Space Agency", "abbrev": "ISA", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 32, "name": "Iran", "alpha_2_code": "IR", "alpha_3_code": "IRN", "nationality_name": "Iranian", "nationality_name_composed": "Irano" } ], "description": "The Iranian Space Agency is Iran's governmental space agency. Iran became an orbital-launch-capable nation in 2009. Iran is one of the 24 founding members of the United Nations Committee on the Peaceful Uses of Outer Space, which was set up in 1958.", "administrator": "Administrator: Hassan Salarieh", "founding_year": 2004, "launchers": "Safir | Simorgh", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 145, "name": "[AUTO] Iranian Space Agency - logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/iranian2520space2520agency_logo_20200422091550.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185013.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": null, "total_launch_count": 15, "consecutive_successful_launches": 2, "successful_launches": 6, "failed_launches": 9, "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.isa.ir/", "wiki_url": "https://en.wikipedia.org/wiki/Iranian_Space_Agency", "social_media_links": [] } ], "parent": null, "description": "", "active": true, "maiden_flight": "2008-08-16", "total_launch_count": 8, "consecutive_successful_launches": 0, "successful_launches": 4, "failed_launches": 4, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Safir", "variant": "", "active": true, "is_placeholder": false, "program": [], "reusable": false, "image": null, "info_url": null, "wiki_url": null, "description": "", "alias": "", "min_stage": 1, "max_stage": 2, "length": 22.0, "diameter": 1.25, "maiden_flight": "2008-08-16", "launch_cost": null, "launch_mass": 26.0, "leo_capacity": 0.0, "gto_capacity": 0.0, "geo_capacity": null, "sso_capacity": null, "to_thrust": 255.0, "apogee": 250.0, "total_launch_count": 5, "consecutive_successful_launches": 4, "successful_launches": 4, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P169DT23H2M" }, { "response_mode": "detailed", "id": 74, "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/74/?format=api", "name": "Safir 1B", "families": [ { "response_mode": "detailed", "id": 136, "name": "Nodong", "manufacturer": [ { "response_mode": "normal", "id": 34, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/34/?format=api", "name": "Iranian Space Agency", "abbrev": "ISA", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 32, "name": "Iran", "alpha_2_code": "IR", "alpha_3_code": "IRN", "nationality_name": "Iranian", "nationality_name_composed": "Irano" } ], "description": "The Iranian Space Agency is Iran's governmental space agency. Iran became an orbital-launch-capable nation in 2009. Iran is one of the 24 founding members of the United Nations Committee on the Peaceful Uses of Outer Space, which was set up in 1958.", "administrator": "Administrator: Hassan Salarieh", "founding_year": 2004, "launchers": "Safir | Simorgh", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 145, "name": "[AUTO] Iranian Space Agency - logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/iranian2520space2520agency_logo_20200422091550.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185013.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": null, "total_launch_count": 15, "consecutive_successful_launches": 2, "successful_launches": 6, "failed_launches": 9, "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.isa.ir/", "wiki_url": "https://en.wikipedia.org/wiki/Iranian_Space_Agency", "social_media_links": [] } ], "parent": null, "description": "", "active": true, "maiden_flight": "2008-08-16", "total_launch_count": 8, "consecutive_successful_launches": 0, "successful_launches": 4, "failed_launches": 4, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Safir 1B", "variant": "1B", "active": true, "is_placeholder": false, "program": [], "reusable": false, "image": null, "info_url": null, "wiki_url": null, "description": "", "alias": "", "min_stage": 1, "max_stage": 2, "length": 22.0, "diameter": 1.25, "maiden_flight": "2012-05-23", "launch_cost": null, "launch_mass": 26.0, "leo_capacity": 0.0, "gto_capacity": 0.0, "geo_capacity": null, "sso_capacity": null, "to_thrust": 255.0, "apogee": 250.0, "total_launch_count": 3, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 3, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P122D" }, { "response_mode": "detailed", "id": 142, "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/142/?format=api", "name": "Simorgh", "families": [], "full_name": "Simorgh", "variant": "", "active": true, "is_placeholder": false, "program": [], "reusable": false, "image": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Simorgh_(rocket)", "description": "", "alias": "", "min_stage": null, "max_stage": null, "length": null, "diameter": null, "maiden_flight": "2017-07-27", "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": 7, "consecutive_successful_launches": 2, "successful_launches": 2, "failed_launches": 5, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P201DT3H30M" } ], "spacecraft_list": [] }
