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

{
  "count": 350,
  "next": "https://lldev.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=150&ordering=-consecutive_successful_launches",
  "previous": "https://lldev.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=130&ordering=-consecutive_successful_launches",
  "results": [
    {
      "response_mode": "normal",
      "id": 1011,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1011/?format=api",
      "name": "Moscow Institute of Thermal Technology",
      "abbrev": "MITT",
      "type": {
        "id": 3,
        "name": "Commercial"
      },
      "featured": false,
      "country": [
        {
          "id": 5,
          "name": "Russia",
          "alpha_2_code": "RU",
          "alpha_3_code": "RUS",
          "nationality_name": "Russian",
          "nationality_name_composed": "Russo"
        }
      ],
      "description": "Moscow Institute of Thermal Technology is a Russian (formerly Soviet) engineering and scientific research institute founded on May 13, 1946. The institute is located in the Otradnoye District in the north of Moscow.\r\n\r\nPreviously, it was primarily focused on developing ballistic missiles and rockets to increase the nation's strategic deterrent capability. Today it is also involved in civilian projects and has modified some of its intercontinental ballistic missiles into launch vehicles to be used for satellites.",
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": "Russian Federal Space Agency (ROSCOSMOS)",
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 1010,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1010/?format=api",
      "name": "KB Mashinostroyeniya",
      "abbrev": "",
      "type": {
        "id": 1,
        "name": "Government"
      },
      "featured": false,
      "country": [
        {
          "id": 5,
          "name": "Russia",
          "alpha_2_code": "RU",
          "alpha_3_code": "RUS",
          "nationality_name": "Russian",
          "nationality_name_composed": "Russo"
        }
      ],
      "description": "KB Mashinostroyeniya or KBM for short is a state defence enterprise, scientific and design R&D centre specialised in missile systems located in Kolomna, Moscow region, Russia. Part of Rostec state corporation.",
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 1087,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1087/?format=api",
      "name": "Korea Advanced Institute of Science and Technology",
      "abbrev": "KAIST",
      "type": {
        "id": 4,
        "name": "Educational"
      },
      "featured": false,
      "country": [
        {
          "id": 35,
          "name": "South Korea",
          "alpha_2_code": "KR",
          "alpha_3_code": "KOR",
          "nationality_name": "South Korean",
          "nationality_name_composed": "South Korean"
        }
      ],
      "description": "The Korea Advanced Institute of Science and Technology (KAIST) is a national research university located in Daedeok Innopolis, Daejeon, South Korea. KAIST was established by the Korean government in 1971 as the nation's first public, research-oriented science and engineering institution.",
      "administrator": "President: Lee Kwang-hyung",
      "founding_year": 1971,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": {
        "id": 2077,
        "name": "KAIST Logo",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/kaist_logo_image_20240412170624.png",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/kaist_logo_image_thumbnail_20240412170625.png",
        "credit": "KAIST",
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 3,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/3/?format=api",
      "name": "Mexican Space Agency",
      "abbrev": "AEM",
      "type": {
        "id": 1,
        "name": "Government"
      },
      "featured": false,
      "country": [
        {
          "id": 25,
          "name": "Mexico",
          "alpha_2_code": "MX",
          "alpha_3_code": "MEX",
          "nationality_name": "Mexican",
          "nationality_name_composed": "Mexico"
        }
      ],
      "description": null,
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 196,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/196/?format=api",
      "name": "Land Launch",
      "abbrev": "LL",
      "type": {
        "id": 3,
        "name": "Commercial"
      },
      "featured": false,
      "country": [
        {
          "id": 5,
          "name": "Russia",
          "alpha_2_code": "RU",
          "alpha_3_code": "RUS",
          "nationality_name": "Russian",
          "nationality_name_composed": "Russo"
        }
      ],
      "description": null,
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 50,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/50/?format=api",
      "name": "National Institute of Aeronautics and Space",
      "abbrev": "LAPAN",
      "type": {
        "id": 1,
        "name": "Government"
      },
      "featured": false,
      "country": [
        {
          "id": 64,
          "name": "Indonesia",
          "alpha_2_code": "ID",
          "alpha_3_code": "IDN",
          "nationality_name": "Indonesian",
          "nationality_name_composed": "Indonesian"
        }
      ],
      "description": null,
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 1078,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1078/?format=api",
      "name": "International Institute for Aeronautical Sciences",
      "abbrev": "IIAS",
      "type": {
        "id": 2,
        "name": "Multinational"
      },
      "featured": false,
      "country": [
        {
          "id": 17,
          "name": "Unknown",
          "alpha_2_code": "??",
          "alpha_3_code": "???",
          "nationality_name": "Earthling",
          "nationality_name_composed": "Earthling"
        }
      ],
      "description": "An international research institute specializing in aeronomy, bioastronautics, operational science, and flight test engineering.",
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 182,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/182/?format=api",
      "name": "National Space Agency of the Republic of Kazakhstan",
      "abbrev": "KazCosmos",
      "type": {
        "id": 1,
        "name": "Government"
      },
      "featured": false,
      "country": [
        {
          "id": 44,
          "name": "Kazakhstan",
          "alpha_2_code": "KZ",
          "alpha_3_code": "KAZ",
          "nationality_name": "Kazakh",
          "nationality_name_composed": "Kazakhstani"
        }
      ],
      "description": "The National Space Agency of the Republic of Kazakhstan, or KazCosmos, was founded in 2007. They have launched 3 satellites, 2 of which are still in operation, KazSat-2 and KazSat-3. Their first cosmonaut class had to cosmonauts, one of which, Aidyn Aimbetov, flew aboard the ISS for 10 days. KazCosmos is heavily linked to the Russian Space Agency due to the Russian's primary launch site being Baikonur Cosmodrome, which is located in Kazakhstan.",
      "administrator": "Administrator: Talgat Musabayev",
      "founding_year": 2007,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 183,
      "url": "https://lldev.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-dev.nyc3.digitaloceanspaces.com/media/images/unknown_agency__image_20240409102110.jpg",
        "thumbnail_url": "https://thespacedevs-dev.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": 15,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/15/?format=api",
      "name": "Bulgarian Space Agency",
      "abbrev": "SRI-BAS",
      "type": {
        "id": 1,
        "name": "Government"
      },
      "featured": false,
      "country": [
        {
          "id": 40,
          "name": "Bulgaria",
          "alpha_2_code": "BG",
          "alpha_3_code": "BGR",
          "nationality_name": "Bulgarian",
          "nationality_name_composed": "Bulgaro"
        }
      ],
      "description": "The Bulgarian Space Agency has put two Bulgarians onto the ISS in tandem with the Russian Space Agency. Their involvement in space began with the Interkosmos program that helped Communist Bloc countries get access to Soviet space technology. They contributed cosmonauts for a training class, two of which flew aboard the ISS.",
      "administrator": null,
      "founding_year": 1993,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    }
  ]
}