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=110&ordering=-total_launch_count
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=120&ordering=-total_launch_count",
    "previous": "https://lldev.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=100&ordering=-total_launch_count",
    "results": [
        {
            "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": 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-prod.nyc3.digitaloceanspaces.com/media/images/bundeswehr_logo_20230806165358.png",
                "thumbnail_url": "https://thespacedevs-prod.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": 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": 153,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/153/?format=api",
            "name": "McDonnell Douglas",
            "abbrev": "MDC",
            "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": 1054,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1054/?format=api",
            "name": "Defense Advanced Research Projects Agency",
            "abbrev": "DARPA",
            "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 Defense Advanced Research Projects Agency (DARPA) is a research and development agency of the United States Department of Defense responsible for the development of emerging technologies for use by the military.",
            "administrator": "Director: Stefanie Tompkins",
            "founding_year": 1958,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": {
                "id": 128,
                "name": "[AUTO] Defense Advanced Research Projects Agency - logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/defense2520advanced2520research2520projects2520agency_logo_20230726143005.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184942.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "social_logo": {
                "id": 53,
                "name": "[AUTO] Defense Advanced Research Projects Agency - social_logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/defense2520advanced2520research2520projects2520agency_nation_20230726143005.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184750.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            }
        },
        {
            "response_mode": "normal",
            "id": 1034,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1034/?format=api",
            "name": "No. 5 Research Academy",
            "abbrev": "CASC",
            "type": {
                "id": 1,
                "name": "Government"
            },
            "featured": false,
            "country": [
                {
                    "id": 6,
                    "name": "China",
                    "alpha_2_code": "CN",
                    "alpha_3_code": "CHN",
                    "nationality_name": "Chinese",
                    "nationality_name_composed": "Sino"
                }
            ],
            "description": "First Chinese missile research institution. Active from October 1956 to November 1964.",
            "administrator": null,
            "founding_year": 1956,
            "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": 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": 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": 1025,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1025/?format=api",
            "name": "United States Departement of Defense",
            "abbrev": "DoD",
            "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 DoD is a government agency in the United States. It is in charge of coordinating and supervising all agencies and functions of the government directly related to national security and the United States Armed Forces.",
            "administrator": null,
            "founding_year": 1947,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        }
    ]
}