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

GET /2.3.0/agencies/?format=api&offset=150&ordering=-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=160&ordering=-successful_launches",
  "previous": "https://lldev.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=140&ordering=-successful_launches",
  "results": [
    {
      "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": 1003,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1003/?format=api",
      "name": "Aérospatiale",
      "abbrev": "",
      "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": "Aérospatiale was a French state-owned aerospace manufacturer that built both civilian and military aircraft, rockets and satellites. It was originally known as Société nationale industrielle aérospatiale (SNIAS). Its head office was in the 16th arrondissement of Paris. The name was changed to Aérospatiale during 1970.",
      "administrator": null,
      "founding_year": 1970,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 1089,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1089/?format=api",
      "name": "Korea AeroSpace Administration",
      "abbrev": "KASA",
      "type": {
        "id": 1,
        "name": "Government"
      },
      "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 AeroSpace Administration (KASA; Korean: 우주항공청) is a Korean government-funded space and aeronautics agency. Established under the Ministry of Science and ICT, KASA oversees the Korea Aerospace Research Institute and Korea Astronomy and Space Science Institute. Its headquarters is located in Sacheon, South Gyeongsang Province.",
      "administrator": "President: Yoon Yeongbin",
      "founding_year": 2024,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": {
        "id": 1283,
        "name": "Nuri liftoff from LC-2 (NEXTSat-2 & SNIPE)",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/nuri_liftoff_2_image_20240820080542.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/nuri_liftoff_2_image_thumbnail_20240820080542.jpeg",
        "credit": "KARI/VNA/CVN",
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": false,
        "variants": []
      },
      "logo": {
        "id": 2179,
        "name": "KASA logo",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/kasa_logo_image_20240820080129.png",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/kasa_logo_image_thumbnail_20240820080130.png",
        "credit": "KASA",
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": [
          {
            "id": 9,
            "type": {
              "id": 2,
              "name": "transparent for dark background"
            },
            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/image_variants/kasa_darkbackgr_image_20240820080130.png"
          }
        ]
      },
      "social_logo": {
        "id": 2180,
        "name": "KASA social logo",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/kasa_social_log_image_20240820080237.png",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/kasa_social_log_image_thumbnail_20240820080238.png",
        "credit": "KASA",
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      }
    },
    {
      "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": 245,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/245/?format=api",
      "name": "Regional African Satellite Communication Organization",
      "abbrev": "RASCOM",
      "type": {
        "id": 3,
        "name": "Commercial"
      },
      "featured": false,
      "country": [
        {
          "id": 91,
          "name": "Mauritius",
          "alpha_2_code": "MU",
          "alpha_3_code": "MUS",
          "nationality_name": "Mauritian",
          "nationality_name_composed": "Mauritian"
        }
      ],
      "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": 1086,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1086/?format=api",
      "name": "NASA Goddard Space Flight Center",
      "abbrev": "GSFC",
      "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 Goddard Space Flight Center (GSFC) is a major NASA space research laboratory located northeast of Washington, D.C. in Greenbelt, Maryland, United States.",
      "administrator": "Director: Makenzie Lystrup",
      "founding_year": 1959,
      "launchers": "",
      "spacecraft": "",
      "parent": "National Aeronautics and Space Administration",
      "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": 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
    }
  ]
}