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

{
    "count": 337,
    "next": "https://ll.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=110&ordering=pending_launches",
    "previous": "https://ll.thespacedevs.com/2.3.0/agencies/?format=api&limit=10&offset=90&ordering=pending_launches",
    "results": [
        {
            "response_mode": "normal",
            "id": 1004,
            "url": "https://ll.thespacedevs.com/2.3.0/agencies/1004/?format=api",
            "name": "Convair",
            "abbrev": "",
            "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": "Convair, previously Consolidated Vultee, was an American aircraft manufacturing company that later expanded into rockets and spacecraft. The company was formed in 1943 by the merger of Consolidated Aircraft and Vultee Aircraft. In 1953 it was purchased by General Dynamics, and operated as their Convair Division for most of its corporate history.",
            "administrator": null,
            "founding_year": 1943,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 123,
            "url": "https://ll.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": 274,
            "url": "https://ll.thespacedevs.com/2.3.0/agencies/274/?format=api",
            "name": "i-Space",
            "abbrev": "i-Space",
            "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": "i-Space is a Chinese private space launch company based in Beijing and founded in October 2016.",
            "administrator": null,
            "founding_year": 2016,
            "launchers": "Hyperbola-1",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": {
                "id": 149,
                "name": "[AUTO] iSpace - logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ispace_logo_20231217083222.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185019.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "social_logo": {
                "id": 68,
                "name": "[AUTO] iSpace - social_logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ispace_nation_20231217083130.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184812.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            }
        },
        {
            "response_mode": "normal",
            "id": 186,
            "url": "https://ll.thespacedevs.com/2.3.0/agencies/186/?format=api",
            "name": "Polish Space Agency",
            "abbrev": "POLSA",
            "type": {
                "id": 1,
                "name": "Government"
            },
            "featured": false,
            "country": [
                {
                    "id": 39,
                    "name": "Poland",
                    "alpha_2_code": "PL",
                    "alpha_3_code": "POL",
                    "nationality_name": "Polish",
                    "nationality_name_composed": "Polono"
                }
            ],
            "description": null,
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 134,
            "url": "https://ll.thespacedevs.com/2.3.0/agencies/134/?format=api",
            "name": "American Rocket Company",
            "abbrev": "AMROC",
            "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": 205,
            "url": "https://ll.thespacedevs.com/2.3.0/agencies/205/?format=api",
            "name": "Inmarsat",
            "abbrev": "ISAT",
            "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": "Inmarsat is a British satellite telecommunications company, offering global mobile services. It provides telephone and data services to users worldwide, via portable or mobile terminals which communicate with ground stations through fifteen geostationary telecommunications satellites.",
            "administrator": "CEO: Rajeev Suri",
            "founding_year": 1979,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 1072,
            "url": "https://ll.thespacedevs.com/2.3.0/agencies/1072/?format=api",
            "name": "Cabinet Intelligence and Research Office",
            "abbrev": "Naichō",
            "type": {
                "id": 1,
                "name": "Government"
            },
            "featured": false,
            "country": [
                {
                    "id": 28,
                    "name": "Japan",
                    "alpha_2_code": "JP",
                    "alpha_3_code": "JPN",
                    "nationality_name": "Japanese",
                    "nationality_name_composed": "Nippo"
                }
            ],
            "description": "The Cabinet Intelligence and Research Office also known as Naichō (内調), is a Japanese intelligence agency under the Cabinet Secretariat responsible for gathering, processing, and analyzing national security information for the cabinet.",
            "administrator": "Director of Cabinet Intelligence: Hiroaki Takizawa",
            "founding_year": 1986,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": {
                "id": 119,
                "name": "[AUTO] Cabinet Intelligence and Research Office - logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cabinet2520intelligence2520and2520research2520office_logo_20230821082601.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184926.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "social_logo": null
        },
        {
            "response_mode": "normal",
            "id": 211,
            "url": "https://ll.thespacedevs.com/2.3.0/agencies/211/?format=api",
            "name": "National Security Agency",
            "abbrev": "NSA",
            "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": 191,
            "url": "https://ll.thespacedevs.com/2.3.0/agencies/191/?format=api",
            "name": "United Space Alliance",
            "abbrev": "USA",
            "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": "United Space Alliance (USA) is a spaceflight operations company. USA is a joint venture which was established in August 1995 as a Limited Liability Company (LLC), equally owned by Boeing and Lockheed Martin.",
            "administrator": null,
            "founding_year": 1995,
            "launchers": "Space Shuttle",
            "spacecraft": "",
            "parent": null,
            "image": {
                "id": 31,
                "name": "[AUTO] United Space Alliance - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520space2520alliance_image_20190830220958.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184709.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "logo": {
                "id": 192,
                "name": "[AUTO] United Space Alliance - logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520space2520alliance_logo_20190830220958.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185150.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "social_logo": {
                "id": 98,
                "name": "[AUTO] United Space Alliance - social_logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520space2520alliance_nation_20190830220958.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184854.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            }
        },
        {
            "response_mode": "normal",
            "id": 47,
            "url": "https://ll.thespacedevs.com/2.3.0/agencies/47/?format=api",
            "name": "National Commission for Aerospace Research and Development",
            "abbrev": "CONIDA",
            "type": {
                "id": 1,
                "name": "Government"
            },
            "featured": false,
            "country": [
                {
                    "id": 71,
                    "name": "Peru",
                    "alpha_2_code": "PE",
                    "alpha_3_code": "PER",
                    "nationality_name": "Peruvian",
                    "nationality_name_composed": "Peruvian"
                }
            ],
            "description": null,
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": null,
            "image": null,
            "logo": null,
            "social_logo": null
        }
    ]
}