GET

Agency List

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

{
    "count": 340,
    "next": "https://lldev.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=30&ordering=-successful_landings",
    "previous": "https://lldev.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=10&ordering=-successful_landings",
    "results": [
        {
            "response_mode": "normal",
            "id": 106,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/106/?format=api",
            "name": "General Dynamics",
            "abbrev": "GD",
            "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": 143,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/143/?format=api",
            "name": "PlanetSpace",
            "abbrev": "PlanetSpace",
            "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": 145,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/145/?format=api",
            "name": "XCOR  Aerospace",
            "abbrev": "XCOR",
            "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": 127,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/127/?format=api",
            "name": "Robotics Institute",
            "abbrev": "RI",
            "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": 88,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
            "name": "China Aerospace Science and Technology Corporation",
            "abbrev": "CASC",
            "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 Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a range of spacecraft, launch vehicles, strategic and tactical missile systems, and ground equipment. It was officially established in July 1999 as part of a Chinese government reform drive, having previously been one part of the former China Aerospace Corporation. Various incarnations of the program date back to 1956.",
            "administrator": "Chairman & President: Lei Fanpei",
            "founding_year": 1999,
            "launchers": "Long March",
            "spacecraft": "",
            "parent": null,
            "image": {
                "id": 8,
                "name": "[AUTO] China Aerospace Science and Technology Corporation - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184558.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "logo": {
                "id": 124,
                "name": "[AUTO] China Aerospace Science and Technology Corporation - logo",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184933.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "social_logo": {
                "id": 50,
                "name": "[AUTO] China Aerospace Science and Technology Corporation - social_logo",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184746.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            }
        },
        {
            "response_mode": "normal",
            "id": 225,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/225/?format=api",
            "name": "1worldspace",
            "abbrev": "1WSP",
            "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": "A now nonexistent satellite radio network company that operated two satellites to bring coverage with 62 stations to most of the Eastern Hemisphere. They went bankrupt in 2008. There has been a plan to relaunch the company, but it was announced in 2011, and nothing has been done since.",
            "administrator": null,
            "founding_year": 1960,
            "launchers": "",
            "spacecraft": "AfriStar | AsiaStar",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 1055,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1055/?format=api",
            "name": "Bundeswehr",
            "abbrev": "",
            "type": {
                "id": 1,
                "name": "Government"
            },
            "featured": false,
            "country": [
                {
                    "id": 4,
                    "name": "Germany",
                    "alpha_2_code": "DE",
                    "alpha_3_code": "DEU",
                    "nationality_name": "German",
                    "nationality_name_composed": "Germano"
                }
            ],
            "description": "The Bundeswehr is the armed forces of the Federal Republic of Germany.",
            "administrator": "Commander-in-Chief : Federal Minister of Defence",
            "founding_year": 1955,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": {
                "id": 118,
                "name": "[AUTO] Bundeswehr - logo",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/bundeswehr_logo_20230806165358.png",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184924.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 136,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/136/?format=api",
            "name": "Ad Astra Rocket Company",
            "abbrev": "AARC",
            "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": "Ad Astra Rocket Company is an American Space Company doing research and development in plasma propulsion technology. This involves using the technology of VASIMR developed in the late '70s, developed by the companies founder, Franklin Diaz. They have begun testing of their VF-200 model engine, built for interplanetary travel.",
            "administrator": "President: Dr. Franklin Chang Diaz",
            "founding_year": 2005,
            "launchers": "",
            "spacecraft": "VX-200 | VF-200",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 151,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/151/?format=api",
            "name": "Swedish Space Corp",
            "abbrev": "SSC",
            "type": {
                "id": 3,
                "name": "Commercial"
            },
            "featured": false,
            "country": [
                {
                    "id": 15,
                    "name": "Sweden",
                    "alpha_2_code": "SE",
                    "alpha_3_code": "SWE",
                    "nationality_name": "Swedish",
                    "nationality_name_composed": "Swedo"
                }
            ],
            "description": null,
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 203,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/203/?format=api",
            "name": "SES",
            "abbrev": "SES",
            "type": {
                "id": 3,
                "name": "Commercial"
            },
            "featured": false,
            "country": [
                {
                    "id": 85,
                    "name": "Luxembourg",
                    "alpha_2_code": "LU",
                    "alpha_3_code": "LUX",
                    "nationality_name": "Luxembourger",
                    "nationality_name_composed": "Luxembourgish"
                }
            ],
            "description": null,
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        }
    ]
}