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

{
    "count": 349,
    "next": "https://lldev.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=110&ordering=successful_landings",
    "previous": "https://lldev.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=90&ordering=successful_landings",
    "results": [
        {
            "response_mode": "normal",
            "id": 1021,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1021/?format=api",
            "name": "Galactic Energy",
            "abbrev": "GE",
            "type": {
                "id": 3,
                "name": "Commercial"
            },
            "featured": false,
            "country": [
                {
                    "id": 6,
                    "name": "China",
                    "alpha_2_code": "CN",
                    "alpha_3_code": "CHN",
                    "nationality_name": "Chinese",
                    "nationality_name_composed": "Sino"
                }
            ],
            "description": "Galactic Energy is a private aerospace company headquartered in Beijing, China. Established by senior engineers in 2018, Galactic Energy engages in low-cost commercial space launch business.",
            "administrator": null,
            "founding_year": 2018,
            "launchers": "Ceres-1 | Pallas-1",
            "spacecraft": "",
            "parent": null,
            "image": {
                "id": 11,
                "name": "[AUTO] Galactic Energy - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic_energy_image_20201106095228.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184607.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "logo": {
                "id": 135,
                "name": "[AUTO] Galactic Energy - logo",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_logo_20201106095229.png",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184957.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "social_logo": {
                "id": 59,
                "name": "[AUTO] Galactic Energy - social_logo",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_nation_20230703094321.png",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184759.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            }
        },
        {
            "response_mode": "normal",
            "id": 123,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/123/?format=api",
            "name": "Starsem SA",
            "abbrev": "SSA",
            "type": {
                "id": 3,
                "name": "Commercial"
            },
            "featured": false,
            "country": [
                {
                    "id": 1,
                    "name": "France",
                    "alpha_2_code": "FR",
                    "alpha_3_code": "FRA",
                    "nationality_name": "French",
                    "nationality_name_composed": "Franco"
                },
                {
                    "id": 5,
                    "name": "Russia",
                    "alpha_2_code": "RU",
                    "alpha_3_code": "RUS",
                    "nationality_name": "Russian",
                    "nationality_name_composed": "Russo"
                }
            ],
            "description": "Starsem is a French-Russian company that was created in 1996 to commercialise the Soyuz launcher internationally.",
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 243,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/243/?format=api",
            "name": "Hughes",
            "abbrev": "HUGH",
            "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": 146,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/146/?format=api",
            "name": "Canadian Arrow",
            "abbrev": "Canadian Arrow",
            "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": null,
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 201,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/201/?format=api",
            "name": "Vector",
            "abbrev": "VEC",
            "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": 213,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/213/?format=api",
            "name": "Missile Defense Agency",
            "abbrev": "MDA",
            "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": 244,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/244/?format=api",
            "name": "Star One",
            "abbrev": "STA1",
            "type": {
                "id": 3,
                "name": "Commercial"
            },
            "featured": false,
            "country": [
                {
                    "id": 24,
                    "name": "Brazil",
                    "alpha_2_code": "BR",
                    "alpha_3_code": "BRA",
                    "nationality_name": "Brazilian",
                    "nationality_name_composed": "Brazilian"
                }
            ],
            "description": null,
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 86,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/86/?format=api",
            "name": "Ball Aerospace & Technologies Corp.",
            "abbrev": "BLL",
            "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": 87,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/87/?format=api",
            "name": "British Aerospace",
            "abbrev": "BAE",
            "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": null,
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "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
        }
    ]
}