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 - ll.thespacedevs.com/docs

GET /2.3.0/agencies/?format=api&offset=330&ordering=-consecutive_successful_launches
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "count": 337,
    "next": null,
    "previous": "https://ll.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=320&ordering=-consecutive_successful_launches",
    "results": [
        {
            "response_mode": "normal",
            "id": 177,
            "url": "https://ll.thespacedevs.com/2.3.0/agencies/177/?format=api",
            "name": "China Great Wall Industry Corporation",
            "abbrev": "CGWIC",
            "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": null,
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 240,
            "url": "https://ll.thespacedevs.com/2.3.0/agencies/240/?format=api",
            "name": "Optus",
            "abbrev": "OPT",
            "type": {
                "id": 3,
                "name": "Commercial"
            },
            "featured": false,
            "country": [
                {
                    "id": 34,
                    "name": "Australia",
                    "alpha_2_code": "AU",
                    "alpha_3_code": "AUS",
                    "nationality_name": "Australian",
                    "nationality_name_composed": "Australo"
                }
            ],
            "description": null,
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 1039,
            "url": "https://ll.thespacedevs.com/2.3.0/agencies/1039/?format=api",
            "name": "Magellan Aerospace Corporation",
            "abbrev": "MAC",
            "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": "Magellan Aerospace Corporation is a Canadian manufacturer of aerospace systems and components.",
            "administrator": "CEO: Phillip Underwood",
            "founding_year": 1996,
            "launchers": "Black Brant",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": {
                "id": 157,
                "name": "[AUTO] Magellan Aerospace Corporation - logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/magellan2520aerospace2520corporation_logo_20220622160105.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185034.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "social_logo": {
                "id": 74,
                "name": "[AUTO] Magellan Aerospace Corporation - social_logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/magellan2520aerospace2520corporation_nation_20220622160105.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184820.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            }
        },
        {
            "response_mode": "normal",
            "id": 1044,
            "url": "https://ll.thespacedevs.com/2.3.0/agencies/1044/?format=api",
            "name": "ArianeGroup",
            "abbrev": "AG",
            "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"
                }
            ],
            "description": "ArianeGroup (formerly Airbus Safran Launchers) is an aerospace company based in France. A joint venture between Airbus and Safran, the company was founded in 2015 and is headquartered in Issy-les-Moulineaux. It consists of three core arms: aerospace, defence and security.",
            "administrator": "CEO: Martin Sion",
            "founding_year": 2015,
            "launchers": "Ariane",
            "spacecraft": "",
            "parent": null,
            "image": {
                "id": 1692,
                "name": "Ariane 62 on ELA-4 (Maiden Flight)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_thumbnail_20240708201808.jpeg",
                "credit": "ESA/L. Bourgeon",
                "license": {
                    "id": 2,
                    "name": "ESA Standard Licence",
                    "priority": 2,
                    "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website"
                },
                "single_use": false,
                "variants": []
            },
            "logo": {
                "id": 107,
                "name": "ArianeGroup logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianegroup_logo_20221130111224.PNG",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184908.png",
                "credit": "ArianeGroup",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": [
                    {
                        "id": 13,
                        "type": {
                            "id": 1,
                            "name": "transparent for light background"
                        },
                        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/image_variants/arianegroup_log_image_20250211190245.PNG"
                    },
                    {
                        "id": 14,
                        "type": {
                            "id": 2,
                            "name": "transparent for dark background"
                        },
                        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/image_variants/arianegroup_log_image_20250211190245.PNG"
                    }
                ]
            },
            "social_logo": {
                "id": 38,
                "name": "ArianeGroup social logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianegroup_nation_20230802053255.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184726.jpeg",
                "credit": "ArianeGroup",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            }
        },
        {
            "response_mode": "normal",
            "id": 1041,
            "url": "https://ll.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": 1053,
            "url": "https://ll.thespacedevs.com/2.3.0/agencies/1053/?format=api",
            "name": "Turkish Air Force",
            "abbrev": "TAF",
            "type": {
                "id": 1,
                "name": "Government"
            },
            "featured": false,
            "country": [
                {
                    "id": 18,
                    "name": "Turkey",
                    "alpha_2_code": "TR",
                    "alpha_3_code": "TUR",
                    "nationality_name": "Turkish",
                    "nationality_name_composed": "Turco"
                }
            ],
            "description": "The Turkish Air Force is the aerial warfare service branch of the Turkish Armed Forces. It traces its origins to June 1911 when it was founded as the Ottoman Aviation Squadrons by the Ottoman Empire.",
            "administrator": null,
            "founding_year": 1911,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": {
                "id": 190,
                "name": "[AUTO] Turkish Air Force - logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/turkish2520air2520force_logo_20230630072904.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185146.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 146,
            "url": "https://ll.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
        }
    ]
}