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

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

{
  "count": 349,
  "next": null,
  "previous": "https://ll.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=330&ordering=-failed_launches",
  "results": [
    {
      "response_mode": "normal",
      "id": 86,
      "url": "https://ll.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": 10,
      "url": "https://ll.thespacedevs.com/2.3.0/agencies/10/?format=api",
      "name": "Belgian Institute for Space Aeronomy",
      "abbrev": "BIRA",
      "type": {
        "id": 1,
        "name": "Government"
      },
      "featured": false,
      "country": [
        {
          "id": 20,
          "name": "Belgium",
          "alpha_2_code": "BE",
          "alpha_3_code": "BEL",
          "nationality_name": "Belgian",
          "nationality_name_composed": "Belgo"
        }
      ],
      "description": null,
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 183,
      "url": "https://ll.thespacedevs.com/2.3.0/agencies/183/?format=api",
      "name": "Unknown",
      "abbrev": "UNK",
      "type": {
        "id": 6,
        "name": "Unknown"
      },
      "featured": false,
      "country": [
        {
          "id": 17,
          "name": "Unknown",
          "alpha_2_code": "??",
          "alpha_3_code": "???",
          "nationality_name": "Earthling",
          "nationality_name_composed": "Earthling"
        }
      ],
      "description": "The agency or launch service provider is not known yet.",
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": {
        "id": 2048,
        "name": "Unknown Agency Question Mark Social Logo",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/unknown_agency__image_20240409102110.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/unknown_agency__image_thumbnail_20240409102110.jpeg",
        "credit": "TheSpaceDevs",
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      }
    },
    {
      "response_mode": "normal",
      "id": 123,
      "url": "https://ll.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": 1054,
      "url": "https://ll.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": 153,
      "url": "https://ll.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": 1056,
      "url": "https://ll.thespacedevs.com/2.3.0/agencies/1056/?format=api",
      "name": "Space Development Agency",
      "abbrev": "SDA",
      "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 Space Development Agency (SDA) is a United States Space Force direct-reporting unit tasked with deploying disruptive space technology. A primary focus is space-based missile defense using large global satellite constellations made up of industry-procured low-cost satellites.",
      "administrator": "Director: Derek Tournear",
      "founding_year": 2019,
      "launchers": "",
      "spacecraft": "",
      "parent": "United States Space Force",
      "image": null,
      "logo": {
        "id": 184,
        "name": "[AUTO] Space Development Agency - logo",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/space2520development2520agency_logo_20230806170522.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185134.jpeg",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 95,
      "url": "https://ll.thespacedevs.com/2.3.0/agencies/95/?format=api",
      "name": "Israel Aerospace Industries",
      "abbrev": "IAI",
      "type": {
        "id": 3,
        "name": "Commercial"
      },
      "featured": false,
      "country": [
        {
          "id": 29,
          "name": "Israel",
          "alpha_2_code": "IL",
          "alpha_3_code": "ISR",
          "nationality_name": "Israeli",
          "nationality_name_composed": "Israeli"
        }
      ],
      "description": null,
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 1057,
      "url": "https://ll.thespacedevs.com/2.3.0/agencies/1057/?format=api",
      "name": "Maxar Technologies",
      "abbrev": "Maxar",
      "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": "Maxar Technologies Inc. is a space technology company headquartered in Westminster, Colorado, United States, specializing in manufacturing communication, Earth observation, radar, and on-orbit servicing satellites, satellite products, and related services.",
      "administrator": "President & CEO: Daniel Jablonsky",
      "founding_year": 2017,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": {
        "id": 158,
        "name": "[AUTO] Maxar Technologies - logo",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/maxar2520technologies_logo_20230806171500.png",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185036.png",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "social_logo": null
    }
  ]
}