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

{
  "count": 350,
  "next": "https://ll.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=30&ordering=pending_launches",
  "previous": "https://ll.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=10&ordering=pending_launches",
  "results": [
    {
      "response_mode": "normal",
      "id": 39,
      "url": "https://ll.thespacedevs.com/2.3.0/agencies/39/?format=api",
      "name": "Kazakh Space Research Institute",
      "abbrev": "SRI",
      "type": {
        "id": 4,
        "name": "Educational"
      },
      "featured": false,
      "country": [
        {
          "id": 44,
          "name": "Kazakhstan",
          "alpha_2_code": "KZ",
          "alpha_3_code": "KAZ",
          "nationality_name": "Kazakh",
          "nationality_name_composed": "Kazakhstani"
        }
      ],
      "description": null,
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 3,
      "url": "https://ll.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": 45,
      "url": "https://ll.thespacedevs.com/2.3.0/agencies/45/?format=api",
      "name": "National Authority for Remote Sensing and Space Sciences",
      "abbrev": "NARSS",
      "type": {
        "id": 1,
        "name": "Government"
      },
      "featured": false,
      "country": [
        {
          "id": 22,
          "name": "Egypt",
          "alpha_2_code": "EG",
          "alpha_3_code": "EGY",
          "nationality_name": "Egyptian",
          "nationality_name_composed": "Egypto"
        }
      ],
      "description": null,
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 14,
      "url": "https://ll.thespacedevs.com/2.3.0/agencies/14/?format=api",
      "name": "Bolivian Space Agency",
      "abbrev": "ABAE",
      "type": {
        "id": 1,
        "name": "Government"
      },
      "featured": false,
      "country": [
        {
          "id": 74,
          "name": "Bolivia",
          "alpha_2_code": "BO",
          "alpha_3_code": "BOL",
          "nationality_name": "Bolivian",
          "nationality_name_composed": "Bolivian"
        }
      ],
      "description": null,
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 40,
      "url": "https://ll.thespacedevs.com/2.3.0/agencies/40/?format=api",
      "name": "Korean Committee of Space Technology",
      "abbrev": "KCST",
      "type": {
        "id": 1,
        "name": "Government"
      },
      "featured": false,
      "country": [
        {
          "id": 53,
          "name": "North Korea",
          "alpha_2_code": "KP",
          "alpha_3_code": "PRK",
          "nationality_name": "North Korean",
          "nationality_name_composed": "North Korean"
        }
      ],
      "description": "The Korean Committee of Space Technology was the agency of the government of the Democratic People's Republic of Korea (North Korea) responsible for the country's space program. The agency was terminated and succeeded by the National Aerospace Development Administration in 2013 after the Law on Space Development was passed in the 7th session of the 12th Supreme People's Assembly.",
      "administrator": null,
      "founding_year": null,
      "launchers": "Paektusan | Unha",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 249,
      "url": "https://ll.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": 93,
      "url": "https://ll.thespacedevs.com/2.3.0/agencies/93/?format=api",
      "name": "Hughes Aircraft",
      "abbrev": "HAC",
      "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": 199,
      "url": "https://ll.thespacedevs.com/2.3.0/agencies/199/?format=api",
      "name": "Virgin Orbit",
      "abbrev": "VO",
      "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": "Virgin Orbit is a company within the Virgin Group which plans to provide launch services for small satellites. The company was formed in 2017 to develop the air-launched LauncherOne rocket, launched from Cosmic Girl, which had previously been a project of Virgin Galactic. Based in Long Beach, California, Virgin Orbit has more than 300 employees led by president Dan Hart, a former vice president of government satellite systems at Boeing.\r\n\r\nVirgin Orbit focuses on small satellite launch, which is one of three capabilities being focused on by Virgin Galactic. These capabilities are: human spaceflight operations, small satellite launch, and advanced aerospace design, manufacturing, and test",
      "administrator": "President: Dan Hart",
      "founding_year": 2017,
      "launchers": "LauncherOne",
      "spacecraft": "",
      "parent": null,
      "image": {
        "id": 33,
        "name": "Virgin Orbit LauncherOne",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_image_20200101110056.jpeg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184714.jpeg",
        "credit": "Virgin Orbit",
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "logo": {
        "id": 197,
        "name": "[AUTO] Virgin Orbit - logo",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_logo_20200101102856.png",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185202.png",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "social_logo": {
        "id": 102,
        "name": "[AUTO] Virgin Orbit - social_logo",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_nation_20200101103026.jpeg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184859.jpeg",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      }
    },
    {
      "response_mode": "normal",
      "id": 129,
      "url": "https://ll.thespacedevs.com/2.3.0/agencies/129/?format=api",
      "name": "Tethers Unlimited, Inc.",
      "abbrev": "TUI",
      "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": 158,
      "url": "https://ll.thespacedevs.com/2.3.0/agencies/158/?format=api",
      "name": "Chrysler",
      "abbrev": "CHR",
      "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": "In July 1959, NASA chose the Redstone missile as the basis for the Mercury-Redstone Launch Vehicle to be used for suborbital test flights of the Project Mercury spacecraft. Three unmanned MRLV launch attempts were made between November 1960 and March 1961, two of which were successful. The MRLV successfully launched the chimpanzee Ham, and astronauts Alan Shepard and Gus Grissom on three suborbital flights in January, May and July 1961, respectively.",
      "administrator": null,
      "founding_year": 1950,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": {
        "id": 52,
        "name": "[AUTO] Chrysler - social_logo",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/chrysler_nation_20190701071744.png",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184749.png",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      }
    }
  ]
}