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=100&ordering=-failed_landings
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "count": 337,
    "next": "https://lldev.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=110&ordering=-failed_landings",
    "previous": "https://lldev.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=90&ordering=-failed_landings",
    "results": [
        {
            "response_mode": "normal",
            "id": 71,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/71/?format=api",
            "name": "Swiss Space Office",
            "abbrev": "SSO",
            "type": {
                "id": 1,
                "name": "Government"
            },
            "featured": false,
            "country": [
                {
                    "id": 8,
                    "name": "Switzerland",
                    "alpha_2_code": "CH",
                    "alpha_3_code": "CHE",
                    "nationality_name": "Swiss",
                    "nationality_name_composed": "Swiss"
                }
            ],
            "description": null,
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 208,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/208/?format=api",
            "name": "Telesat",
            "abbrev": "TELE",
            "type": {
                "id": 3,
                "name": "Commercial"
            },
            "featured": false,
            "country": [
                {
                    "id": 26,
                    "name": "Canada",
                    "alpha_2_code": "CA",
                    "alpha_3_code": "CAN",
                    "nationality_name": "Canadian",
                    "nationality_name_composed": "Canado"
                }
            ],
            "description": "Telesat, formerly Telesat Canada, is a Canadian satellite communications company founded on May 2, 1969.",
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 211,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/211/?format=api",
            "name": "National Security Agency",
            "abbrev": "NSA",
            "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": null,
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "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": 233,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/233/?format=api",
            "name": "Direction générale de l'armement",
            "abbrev": "DGA",
            "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": null,
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 227,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/227/?format=api",
            "name": "UK Ministry Of Defence",
            "abbrev": "UKMOD",
            "type": {
                "id": 1,
                "name": "Government"
            },
            "featured": false,
            "country": [
                {
                    "id": 10,
                    "name": "United Kingdom",
                    "alpha_2_code": "GB",
                    "alpha_3_code": "GBR",
                    "nationality_name": "British",
                    "nationality_name_composed": "Brito"
                }
            ],
            "description": null,
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 1007,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1007/?format=api",
            "name": "Space Services Inc.",
            "abbrev": "",
            "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": "Space Services, Inc. of America (SSIA) is a space services company that provides star naming services as well as space burial services through its subsidiary company, Celestis.",
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 1041,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1041/?format=api",
            "name": "United States Space Force",
            "abbrev": "USSF",
            "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 Space Force (USSF) is the space service branch of the U.S. Armed Forces, one of the eight U.S. uniformed services.",
            "administrator": null,
            "founding_year": 2019,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": {
                "id": 194,
                "name": "[AUTO] United States Space Force - logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520space2520force_logo_20221102113048.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185155.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 249,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/249/?format=api",
            "name": "Echostar",
            "abbrev": "ECHO",
            "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
        },
        {
            "response_mode": "normal",
            "id": 17,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api",
            "name": "China National Space Administration",
            "abbrev": "CNSA",
            "type": {
                "id": 1,
                "name": "Government"
            },
            "featured": true,
            "country": [
                {
                    "id": 6,
                    "name": "China",
                    "alpha_2_code": "CN",
                    "alpha_3_code": "CHN",
                    "nationality_name": "Chinese",
                    "nationality_name_composed": "Sino"
                }
            ],
            "description": "The China National Space Administration (CNSA) is the national space agency of the People's Republic of China. It is responsible for the national space program and for planning and development of space activities. CNSA and China Aerospace Corporation (CASC) assumed the authority over space development efforts previously held by the Ministry of Aerospace Industry. The CNSA has many launch sites around China with their orbital sites located in Jiuquan, Xichang, Taiyuan and Wenchang.",
            "administrator": "Administrator: Tang Dengjie",
            "founding_year": 1993,
            "launchers": "",
            "spacecraft": "Shenzhou",
            "parent": null,
            "image": {
                "id": 9,
                "name": "[AUTO] China National Space Administration - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_image_20190207032431.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184601.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "logo": {
                "id": 125,
                "name": "[AUTO] China National Space Administration - logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_logo_20190207032431.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184936.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "social_logo": {
                "id": 51,
                "name": "[AUTO] China National Space Administration - social_logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_nation_20190602114400.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184747.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            }
        }
    ]
}