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

{
  "count": 349,
  "next": "https://lldev.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=110&ordering=-failed_landings",
  "previous": "https://lldev.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=90&ordering=-failed_landings",
  "results": [
    {
      "response_mode": "normal",
      "id": 1021,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1021/?format=api",
      "name": "Galactic Energy",
      "abbrev": "GE",
      "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": "Galactic Energy is a private aerospace company headquartered in Beijing, China. Established by senior engineers in 2018, Galactic Energy engages in low-cost commercial space launch business.",
      "administrator": null,
      "founding_year": 2018,
      "launchers": "Ceres-1 | Pallas-1",
      "spacecraft": "",
      "parent": null,
      "image": {
        "id": 11,
        "name": "[AUTO] Galactic Energy - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic_energy_image_20201106095228.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184607.jpeg",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "logo": {
        "id": 135,
        "name": "[AUTO] Galactic Energy - logo",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_logo_20201106095229.png",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184957.png",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "social_logo": {
        "id": 59,
        "name": "[AUTO] Galactic Energy - social_logo",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_nation_20230703094321.png",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184759.png",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      }
    },
    {
      "response_mode": "normal",
      "id": 123,
      "url": "https://lldev.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": 243,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/243/?format=api",
      "name": "Hughes",
      "abbrev": "HUGH",
      "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": 146,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/146/?format=api",
      "name": "Canadian Arrow",
      "abbrev": "Canadian Arrow",
      "type": {
        "id": 3,
        "name": "Commercial"
      },
      "featured": false,
      "country": [
        {
          "id": 26,
          "name": "Canada",
          "alpha_2_code": "CA",
          "alpha_3_code": "CAN",
          "nationality_name": "Canadian",
          "nationality_name_composed": "Canado"
        }
      ],
      "description": null,
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 201,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/201/?format=api",
      "name": "Vector",
      "abbrev": "VEC",
      "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": 213,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/213/?format=api",
      "name": "Missile Defense Agency",
      "abbrev": "MDA",
      "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": null,
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "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": 86,
      "url": "https://lldev.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": 87,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/87/?format=api",
      "name": "British Aerospace",
      "abbrev": "BAE",
      "type": {
        "id": 3,
        "name": "Commercial"
      },
      "featured": false,
      "country": [
        {
          "id": 10,
          "name": "United Kingdom",
          "alpha_2_code": "GB",
          "alpha_3_code": "GBR",
          "nationality_name": "British",
          "nationality_name_composed": "Brito"
        }
      ],
      "description": null,
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    },
    {
      "response_mode": "normal",
      "id": 4,
      "url": "https://lldev.thespacedevs.com/2.3.0/agencies/4/?format=api",
      "name": "Algerian Space Agency",
      "abbrev": "ASAL",
      "type": {
        "id": 1,
        "name": "Government"
      },
      "featured": false,
      "country": [
        {
          "id": 59,
          "name": "Algeria",
          "alpha_2_code": "DZ",
          "alpha_3_code": "DZA",
          "nationality_name": "Algerian",
          "nationality_name_composed": "Algerian"
        }
      ],
      "description": null,
      "administrator": null,
      "founding_year": null,
      "launchers": "",
      "spacecraft": "",
      "parent": null,
      "image": null,
      "logo": null,
      "social_logo": null
    }
  ]
}