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

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/?format=api&offset=40&ordering=-successful_landings
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "count": 348,
    "next": "https://lldev.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=50&ordering=-successful_landings",
    "previous": "https://lldev.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=30&ordering=-successful_landings",
    "results": [
        {
            "response_mode": "normal",
            "id": 161,
            "url": "https://lldev.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-dev.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_logo_20230804084626.png",
                "thumbnail_url": "https://thespacedevs-dev.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-dev.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_nation_20230804085132.jpg",
                "thumbnail_url": "https://thespacedevs-dev.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": []
            }
        },
        {
            "response_mode": "normal",
            "id": 183,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/183/?format=api",
            "name": "Unknown",
            "abbrev": "UNK",
            "type": {
                "id": 6,
                "name": "Unknown"
            },
            "featured": false,
            "country": [
                {
                    "id": 17,
                    "name": "Unknown",
                    "alpha_2_code": "??",
                    "alpha_3_code": "???",
                    "nationality_name": "Earthling",
                    "nationality_name_composed": "Earthling"
                }
            ],
            "description": "The agency or launch service provider is not known yet.",
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": {
                "id": 2048,
                "name": "Unknown Agency Question Mark Social Logo",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/unknown_agency__image_20240409102110.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/unknown_agency__image_thumbnail_20240409102110.jpeg",
                "credit": "TheSpaceDevs",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            }
        },
        {
            "response_mode": "normal",
            "id": 1009,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1009/?format=api",
            "name": "Institute of Space and Astronautical Science",
            "abbrev": "ISAS",
            "type": {
                "id": 1,
                "name": "Government"
            },
            "featured": false,
            "country": [
                {
                    "id": 28,
                    "name": "Japan",
                    "alpha_2_code": "JP",
                    "alpha_3_code": "JPN",
                    "nationality_name": "Japanese",
                    "nationality_name_composed": "Nippo"
                }
            ],
            "description": "ISAS is a Japanese national research organization of astrophysics using rockets, astronomical satellites and interplanetary probes which played a major role in Japan's space development.",
            "administrator": null,
            "founding_year": null,
            "launchers": "Lambda",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 205,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/205/?format=api",
            "name": "Inmarsat",
            "abbrev": "ISAT",
            "type": {
                "id": 3,
                "name": "Commercial"
            },
            "featured": false,
            "country": [
                {
                    "id": 10,
                    "name": "United Kingdom",
                    "alpha_2_code": "GB",
                    "alpha_3_code": "GBR",
                    "nationality_name": "British",
                    "nationality_name_composed": "Brito"
                }
            ],
            "description": "Inmarsat is a British satellite telecommunications company, offering global mobile services. It provides telephone and data services to users worldwide, via portable or mobile terminals which communicate with ground stations through fifteen geostationary telecommunications satellites.",
            "administrator": "CEO: Rajeev Suri",
            "founding_year": 1979,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 1073,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1073/?format=api",
            "name": "DSN Corporation",
            "abbrev": "",
            "type": {
                "id": 3,
                "name": "Commercial"
            },
            "featured": false,
            "country": [
                {
                    "id": 28,
                    "name": "Japan",
                    "alpha_2_code": "JP",
                    "alpha_3_code": "JPN",
                    "nationality_name": "Japanese",
                    "nationality_name_composed": "Nippo"
                }
            ],
            "description": "DSN Corporation Japanese: 株式会社ディー・エス・エヌ is a corporation owned by SKY Perfect JSAT Group, NEC and NTT Com. It was founded on December 19, 2012 for the sole purpose of acting as an investment vehicle in the private finance initiative that would handle the Japanese military X-band DSN satellite network from 2015 to 2031.",
            "administrator": null,
            "founding_year": 2012,
            "launchers": "",
            "spacecraft": "",
            "parent": "SKY Perfect JSAT Group",
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 1003,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1003/?format=api",
            "name": "Aérospatiale",
            "abbrev": "",
            "type": {
                "id": 1,
                "name": "Government"
            },
            "featured": false,
            "country": [
                {
                    "id": 1,
                    "name": "France",
                    "alpha_2_code": "FR",
                    "alpha_3_code": "FRA",
                    "nationality_name": "French",
                    "nationality_name_composed": "Franco"
                }
            ],
            "description": "Aérospatiale was a French state-owned aerospace manufacturer that built both civilian and military aircraft, rockets and satellites. It was originally known as Société nationale industrielle aérospatiale (SNIAS). Its head office was in the 16th arrondissement of Paris. The name was changed to Aérospatiale during 1970.",
            "administrator": null,
            "founding_year": 1970,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 1013,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1013/?format=api",
            "name": "Makeyev Rocket Design Bureau",
            "abbrev": "",
            "type": {
                "id": 3,
                "name": "Commercial"
            },
            "featured": false,
            "country": [
                {
                    "id": 5,
                    "name": "Russia",
                    "alpha_2_code": "RU",
                    "alpha_3_code": "RUS",
                    "nationality_name": "Russian",
                    "nationality_name_composed": "Russo"
                }
            ],
            "description": "The JSC Makeyev Design Bureau is a Russian missile design company located in Miass, Russia.\r\n\r\nEstablished in December 1947 as SKB-385, the company is the main designer of submarine-launched ballistic missiles (SLBM) in Russia. The organization was named in honor of Victor Makeyev. Its full official name is State Rocket Center «Academician V.P. Makeev Design Bureau».\r\n\r\nIn 1965, SKB-385 was redesignated the Design Bureau of Machine-Building (KBM) under the Ministry of General Machine-Building.",
            "administrator": null,
            "founding_year": 1947,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 188,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/188/?format=api",
            "name": "Gilmour Space Technologies",
            "abbrev": "GST",
            "type": {
                "id": 5,
                "name": "Private"
            },
            "featured": false,
            "country": [
                {
                    "id": 34,
                    "name": "Australia",
                    "alpha_2_code": "AU",
                    "alpha_3_code": "AUS",
                    "nationality_name": "Australian",
                    "nationality_name_composed": "Australo"
                },
                {
                    "id": 69,
                    "name": "Singapore",
                    "alpha_2_code": "SG",
                    "alpha_3_code": "SGP",
                    "nationality_name": "Singaporean",
                    "nationality_name_composed": "Singaporean"
                }
            ],
            "description": "Gilmour Space Technologies is a venture-funded Australian space company headquartered in Queensland, Australia that is developing hybrid-engine rockets and associated technology to support the development of a low-cost space launch vehicle.",
            "administrator": "CEO: Adam Gilmour",
            "founding_year": 2013,
            "launchers": "Eris",
            "spacecraft": "",
            "parent": null,
            "image": {
                "id": 1732,
                "name": "Eris on the launch pad (Maiden Flight)",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/eris_on_the_lau_image_20250227073032.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/eris_on_the_lau_image_thumbnail_20250227073032.jpeg",
                "credit": "Gilmour Space",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": false,
                "variants": []
            },
            "logo": {
                "id": 2337,
                "name": "Gilmour Space logo",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gilmour_space_l_image_20250227072818.png",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gilmour_space_l_image_thumbnail_20250227072818.png",
                "credit": "Gilmour Space",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "social_logo": {
                "id": 2336,
                "name": "Gilmour Space social logo",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gilmour_space_s_image_20250227072733.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gilmour_space_s_image_thumbnail_20250227072733.jpeg",
                "credit": "Gilmour Space",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            }
        },
        {
            "response_mode": "normal",
            "id": 119,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/119/?format=api",
            "name": "ISC Kosmotras",
            "abbrev": "ISCK",
            "type": {
                "id": 3,
                "name": "Commercial"
            },
            "featured": false,
            "country": [
                {
                    "id": 5,
                    "name": "Russia",
                    "alpha_2_code": "RU",
                    "alpha_3_code": "RUS",
                    "nationality_name": "Russian",
                    "nationality_name_composed": "Russo"
                }
            ],
            "description": null,
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "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
        }
    ]
}