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/184/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "response_mode": "detailed",
  "id": 184,
  "url": "https://ll.thespacedevs.com/2.3.0/agencies/184/?format=api",
  "name": "China Aerospace Science and Industry Corporation",
  "abbrev": "CASIC",
  "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": "The China Aerospace Science & Industry Corporation Limited (CASIC) is a Chinese state-owned corporation that designs, develops and manufactures a range of spacecrafts, launch vehicles, strategic and tactical missile systems, and ground equipment.",
  "administrator": null,
  "founding_year": null,
  "launchers": "",
  "spacecraft": "",
  "parent": null,
  "image": {
    "id": 7,
    "name": "[AUTO] China Aerospace Science and Industry Corporation - image",
    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china_aerospace_image_20201111143053.png",
    "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184555.png",
    "credit": null,
    "license": {
      "id": 1,
      "name": "Unknown",
      "priority": 9,
      "link": null
    },
    "single_use": true,
    "variants": []
  },
  "logo": {
    "id": 123,
    "name": "[AUTO] China Aerospace Science and Industry Corporation - logo",
    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520industry2520corporation_logo_20201111180047.png",
    "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184932.png",
    "credit": null,
    "license": {
      "id": 1,
      "name": "Unknown",
      "priority": 9,
      "link": null
    },
    "single_use": true,
    "variants": []
  },
  "social_logo": {
    "id": 49,
    "name": "[AUTO] China Aerospace Science and Industry Corporation - social_logo",
    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_20251213035232.jpg",
    "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20251213035233.jpeg",
    "credit": "CASIC",
    "license": {
      "id": 1,
      "name": "Unknown",
      "priority": 9,
      "link": null
    },
    "single_use": true,
    "variants": []
  },
  "total_launch_count": 5,
  "consecutive_successful_launches": 5,
  "successful_launches": 5,
  "failed_launches": 0,
  "pending_launches": 0,
  "consecutive_successful_landings": 0,
  "successful_landings": 0,
  "failed_landings": 0,
  "attempted_landings": 0,
  "successful_landings_spacecraft": 0,
  "failed_landings_spacecraft": 0,
  "attempted_landings_spacecraft": 0,
  "successful_landings_payload": 0,
  "failed_landings_payload": 0,
  "attempted_landings_payload": 0,
  "info_url": "https://english.casic.cn/",
  "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Industry_Corporation",
  "social_media_links": [],
  "launcher_list": [
    {
      "response_mode": "detailed",
      "id": 125,
      "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/125/?format=api",
      "name": "Kaituozhe",
      "families": [
        {
          "response_mode": "detailed",
          "id": 95,
          "name": "Kaituozhe",
          "manufacturer": [
            {
              "response_mode": "normal",
              "id": 88,
              "url": "https://ll.thespacedevs.com/2.3.0/agencies/88/?format=api",
              "name": "China Aerospace Science and Technology Corporation",
              "abbrev": "CASC",
              "type": {
                "id": 1,
                "name": "Government"
              },
              "featured": true,
              "country": [
                {
                  "id": 6,
                  "name": "China",
                  "alpha_2_code": "CN",
                  "alpha_3_code": "CHN",
                  "nationality_name": "Chinese",
                  "nationality_name_composed": "Sino"
                }
              ],
              "description": "The China Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a range of spacecraft, launch vehicles, strategic and tactical missile systems, and ground equipment. It was officially established in July 1999 as part of a Chinese government reform drive, having previously been one part of the former China Aerospace Corporation. Various incarnations of the program date back to 1956.",
              "administrator": "Chairman & President: Lei Fanpei",
              "founding_year": 1999,
              "launchers": "Long March",
              "spacecraft": "",
              "parent": null,
              "image": {
                "id": 8,
                "name": "[AUTO] China Aerospace Science and Technology Corporation - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184558.jpeg",
                "credit": null,
                "license": {
                  "id": 1,
                  "name": "Unknown",
                  "priority": 9,
                  "link": null
                },
                "single_use": true,
                "variants": []
              },
              "logo": {
                "id": 124,
                "name": "[AUTO] China Aerospace Science and Technology Corporation - logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184933.png",
                "credit": null,
                "license": {
                  "id": 1,
                  "name": "Unknown",
                  "priority": 9,
                  "link": null
                },
                "single_use": true,
                "variants": []
              },
              "social_logo": {
                "id": 50,
                "name": "[AUTO] China Aerospace Science and Technology Corporation - social_logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184746.png",
                "credit": null,
                "license": {
                  "id": 1,
                  "name": "Unknown",
                  "priority": 9,
                  "link": null
                },
                "single_use": true,
                "variants": []
              },
              "total_launch_count": 621,
              "consecutive_successful_launches": 12,
              "successful_launches": 605,
              "failed_launches": 16,
              "pending_launches": 9,
              "consecutive_successful_landings": 1,
              "successful_landings": 1,
              "failed_landings": 1,
              "attempted_landings": 2,
              "successful_landings_spacecraft": 3,
              "failed_landings_spacecraft": 0,
              "attempted_landings_spacecraft": 3,
              "successful_landings_payload": 2,
              "failed_landings_payload": 0,
              "attempted_landings_payload": 2,
              "info_url": "https://english.spacechina.com/",
              "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation",
              "social_media_links": []
            }
          ],
          "parent": null,
          "description": "",
          "active": false,
          "maiden_flight": "2002-09-15",
          "total_launch_count": 4,
          "consecutive_successful_launches": 1,
          "successful_launches": 1,
          "failed_launches": 3,
          "pending_launches": 0,
          "attempted_landings": 0,
          "successful_landings": 0,
          "failed_landings": 0,
          "consecutive_successful_landings": 0
        }
      ],
      "full_name": "Kaituozhe-2",
      "variant": "2",
      "active": false,
      "is_placeholder": false,
      "program": [],
      "reusable": false,
      "image": null,
      "info_url": null,
      "wiki_url": "https://en.wikipedia.org/wiki/Kaituozhe-1",
      "description": "",
      "alias": "",
      "min_stage": null,
      "max_stage": null,
      "length": null,
      "diameter": null,
      "maiden_flight": "2017-03-02",
      "launch_cost": null,
      "launch_mass": null,
      "leo_capacity": null,
      "gto_capacity": null,
      "geo_capacity": null,
      "sso_capacity": null,
      "to_thrust": null,
      "apogee": null,
      "total_launch_count": 1,
      "consecutive_successful_launches": 1,
      "successful_launches": 1,
      "failed_launches": 0,
      "pending_launches": 0,
      "attempted_landings": 0,
      "successful_landings": 0,
      "failed_landings": 0,
      "consecutive_successful_landings": 0,
      "fastest_turnaround": null
    },
    {
      "response_mode": "detailed",
      "id": 326,
      "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/326/?format=api",
      "name": "Kaituozhe-1",
      "families": [
        {
          "response_mode": "detailed",
          "id": 95,
          "name": "Kaituozhe",
          "manufacturer": [
            {
              "response_mode": "normal",
              "id": 88,
              "url": "https://ll.thespacedevs.com/2.3.0/agencies/88/?format=api",
              "name": "China Aerospace Science and Technology Corporation",
              "abbrev": "CASC",
              "type": {
                "id": 1,
                "name": "Government"
              },
              "featured": true,
              "country": [
                {
                  "id": 6,
                  "name": "China",
                  "alpha_2_code": "CN",
                  "alpha_3_code": "CHN",
                  "nationality_name": "Chinese",
                  "nationality_name_composed": "Sino"
                }
              ],
              "description": "The China Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a range of spacecraft, launch vehicles, strategic and tactical missile systems, and ground equipment. It was officially established in July 1999 as part of a Chinese government reform drive, having previously been one part of the former China Aerospace Corporation. Various incarnations of the program date back to 1956.",
              "administrator": "Chairman & President: Lei Fanpei",
              "founding_year": 1999,
              "launchers": "Long March",
              "spacecraft": "",
              "parent": null,
              "image": {
                "id": 8,
                "name": "[AUTO] China Aerospace Science and Technology Corporation - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184558.jpeg",
                "credit": null,
                "license": {
                  "id": 1,
                  "name": "Unknown",
                  "priority": 9,
                  "link": null
                },
                "single_use": true,
                "variants": []
              },
              "logo": {
                "id": 124,
                "name": "[AUTO] China Aerospace Science and Technology Corporation - logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184933.png",
                "credit": null,
                "license": {
                  "id": 1,
                  "name": "Unknown",
                  "priority": 9,
                  "link": null
                },
                "single_use": true,
                "variants": []
              },
              "social_logo": {
                "id": 50,
                "name": "[AUTO] China Aerospace Science and Technology Corporation - social_logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184746.png",
                "credit": null,
                "license": {
                  "id": 1,
                  "name": "Unknown",
                  "priority": 9,
                  "link": null
                },
                "single_use": true,
                "variants": []
              },
              "total_launch_count": 621,
              "consecutive_successful_launches": 12,
              "successful_launches": 605,
              "failed_launches": 16,
              "pending_launches": 9,
              "consecutive_successful_landings": 1,
              "successful_landings": 1,
              "failed_landings": 1,
              "attempted_landings": 2,
              "successful_landings_spacecraft": 3,
              "failed_landings_spacecraft": 0,
              "attempted_landings_spacecraft": 3,
              "successful_landings_payload": 2,
              "failed_landings_payload": 0,
              "attempted_landings_payload": 2,
              "info_url": "https://english.spacechina.com/",
              "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation",
              "social_media_links": []
            }
          ],
          "parent": null,
          "description": "",
          "active": false,
          "maiden_flight": "2002-09-15",
          "total_launch_count": 4,
          "consecutive_successful_launches": 1,
          "successful_launches": 1,
          "failed_launches": 3,
          "pending_launches": 0,
          "attempted_landings": 0,
          "successful_landings": 0,
          "failed_landings": 0,
          "consecutive_successful_landings": 0
        }
      ],
      "full_name": "Kaituozhe-1",
      "variant": "1",
      "active": false,
      "is_placeholder": false,
      "program": [],
      "reusable": false,
      "image": null,
      "info_url": null,
      "wiki_url": "https://en.wikipedia.org/wiki/Kaituozhe_(rocket_family)#Kaituozhe-1",
      "description": "A small solid fueled launch vehicle based on the road mobile DF-21 IRBM with an additional upper stage.",
      "alias": "",
      "min_stage": 4,
      "max_stage": 4,
      "length": 18.0,
      "diameter": 2.0,
      "maiden_flight": "2001-09-15",
      "launch_cost": null,
      "launch_mass": 20.0,
      "leo_capacity": 100.0,
      "gto_capacity": null,
      "geo_capacity": null,
      "sso_capacity": null,
      "to_thrust": null,
      "apogee": null,
      "total_launch_count": 3,
      "consecutive_successful_launches": 0,
      "successful_launches": 0,
      "failed_launches": 3,
      "pending_launches": 0,
      "attempted_landings": 0,
      "successful_landings": 0,
      "failed_landings": 0,
      "consecutive_successful_landings": 0,
      "fastest_turnaround": "P366D"
    },
    {
      "response_mode": "detailed",
      "id": 65,
      "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/65/?format=api",
      "name": "Kuaizhou",
      "families": [
        {
          "response_mode": "detailed",
          "id": 100,
          "name": "Kuaizhou",
          "manufacturer": [
            {
              "response_mode": "normal",
              "id": 194,
              "url": "https://ll.thespacedevs.com/2.3.0/agencies/194/?format=api",
              "name": "ExPace",
              "abbrev": "EP",
              "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": "ExPace is a Chinese space rocket company based in Wuhan, Hubei, China. It is a wholly owned subsidiary of missileer China Aerospace Science and Industry Corporation (CASIC), a Chinese state-owned company, and serves as its commercial rocket division. ExPace is focused on small satellite launchers to low Earth orbit.",
              "administrator": "CEO: Zhang Di",
              "founding_year": 2016,
              "launchers": "",
              "spacecraft": "",
              "parent": null,
              "image": null,
              "logo": null,
              "social_logo": {
                "id": 57,
                "name": "[AUTO] ExPace - social_logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/expace_nation_20230608044150.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184756.png",
                "credit": null,
                "license": {
                  "id": 1,
                  "name": "Unknown",
                  "priority": 9,
                  "link": null
                },
                "single_use": true,
                "variants": []
              },
              "total_launch_count": 35,
              "consecutive_successful_launches": 6,
              "successful_launches": 31,
              "failed_launches": 4,
              "pending_launches": 0,
              "consecutive_successful_landings": 0,
              "successful_landings": 0,
              "failed_landings": 0,
              "attempted_landings": 0,
              "successful_landings_spacecraft": 0,
              "failed_landings_spacecraft": 0,
              "attempted_landings_spacecraft": 0,
              "successful_landings_payload": 0,
              "failed_landings_payload": 0,
              "attempted_landings_payload": 0,
              "info_url": null,
              "wiki_url": "https://en.wikipedia.org/wiki/ExPace",
              "social_media_links": []
            }
          ],
          "parent": null,
          "description": "",
          "active": true,
          "maiden_flight": "2017-01-09",
          "total_launch_count": 40,
          "consecutive_successful_launches": 6,
          "successful_launches": 36,
          "failed_launches": 4,
          "pending_launches": 0,
          "attempted_landings": 0,
          "successful_landings": 0,
          "failed_landings": 0,
          "consecutive_successful_landings": 0
        }
      ],
      "full_name": "Kuaizhou",
      "variant": "",
      "active": false,
      "is_placeholder": false,
      "program": [],
      "reusable": false,
      "image": {
        "id": 2071,
        "name": "Kuaizhou-1 liftoff (Maiden Flight)",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/kuaizhou-1_lift_image_20240411121350.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/kuaizhou-1_lift_image_thumbnail_20240411121350.jpeg",
        "credit": "CASIC",
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "info_url": null,
      "wiki_url": "https://en.wikipedia.org/wiki/Kuaizhou",
      "description": "",
      "alias": "",
      "min_stage": 1,
      "max_stage": 4,
      "length": 11.0,
      "diameter": 1.4,
      "maiden_flight": "2013-09-25",
      "launch_cost": null,
      "launch_mass": 20.0,
      "leo_capacity": 0.0,
      "gto_capacity": 0.0,
      "geo_capacity": null,
      "sso_capacity": null,
      "to_thrust": null,
      "apogee": 1000.0,
      "total_launch_count": 2,
      "consecutive_successful_launches": 2,
      "successful_launches": 2,
      "failed_launches": 0,
      "pending_launches": 0,
      "attempted_landings": 0,
      "successful_landings": 0,
      "failed_landings": 0,
      "consecutive_successful_landings": 0,
      "fastest_turnaround": "P422DT2H8S"
    }
  ],
  "spacecraft_list": []
}