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

{
    "response_mode": "detailed",
    "id": 999,
    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/999/?format=api",
    "name": "North American Aviation",
    "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": "North American Aviation (NAA) was a major American aerospace manufacturer, responsible for a number of historic aircraft, including the T-6 Texan trainer, the P-51 Mustang fighter, the B-25 Mitchell bomber, the F-86 Sabre jet fighter, the X-15 rocket plane, and the XB-70, as well as Apollo command and service module, the second stage of the Saturn V rocket, the Space Shuttle orbiter and the B-1 Lancer.",
    "administrator": null,
    "founding_year": 1928,
    "launchers": "North American X-15",
    "spacecraft": "",
    "parent": "Boeing",
    "image": null,
    "logo": {
        "id": 164,
        "name": "[AUTO] North American Aviation - logo",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/north2520american2520aviation_logo_20200711032022.png",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185049.png",
        "credit": null,
        "license": {
            "id": 1,
            "name": "Unknown",
            "priority": 9,
            "link": null
        },
        "single_use": true,
        "variants": []
    },
    "social_logo": null,
    "total_launch_count": 0,
    "consecutive_successful_launches": 0,
    "successful_launches": 0,
    "failed_launches": 0,
    "pending_launches": 0,
    "consecutive_successful_landings": 0,
    "successful_landings": 0,
    "failed_landings": 0,
    "attempted_landings": 0,
    "successful_landings_spacecraft": 20,
    "failed_landings_spacecraft": 0,
    "attempted_landings_spacecraft": 20,
    "successful_landings_payload": 0,
    "failed_landings_payload": 0,
    "attempted_landings_payload": 0,
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/North_American_Aviation",
    "social_media_links": [],
    "launcher_list": [
        {
            "response_mode": "detailed",
            "id": 473,
            "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/473/?format=api",
            "name": "Little Joe",
            "families": [
                {
                    "response_mode": "detailed",
                    "id": 105,
                    "name": "Little Joe",
                    "manufacturer": [
                        {
                            "response_mode": "normal",
                            "id": 1004,
                            "url": "https://lldev.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,
                            "total_launch_count": 1,
                            "consecutive_successful_launches": 1,
                            "successful_launches": 1,
                            "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": null,
                            "wiki_url": "https://en.wikipedia.org/wiki/Convair",
                            "social_media_links": []
                        },
                        {
                            "response_mode": "normal",
                            "id": 999,
                            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/999/?format=api",
                            "name": "North American Aviation",
                            "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": "North American Aviation (NAA) was a major American aerospace manufacturer, responsible for a number of historic aircraft, including the T-6 Texan trainer, the P-51 Mustang fighter, the B-25 Mitchell bomber, the F-86 Sabre jet fighter, the X-15 rocket plane, and the XB-70, as well as Apollo command and service module, the second stage of the Saturn V rocket, the Space Shuttle orbiter and the B-1 Lancer.",
                            "administrator": null,
                            "founding_year": 1928,
                            "launchers": "North American X-15",
                            "spacecraft": "",
                            "parent": "Boeing",
                            "image": null,
                            "logo": {
                                "id": 164,
                                "name": "[AUTO] North American Aviation - logo",
                                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/north2520american2520aviation_logo_20200711032022.png",
                                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185049.png",
                                "credit": null,
                                "license": {
                                    "id": 1,
                                    "name": "Unknown",
                                    "priority": 9,
                                    "link": null
                                },
                                "single_use": true,
                                "variants": []
                            },
                            "social_logo": null,
                            "total_launch_count": 0,
                            "consecutive_successful_launches": 0,
                            "successful_launches": 0,
                            "failed_launches": 0,
                            "pending_launches": 0,
                            "consecutive_successful_landings": 0,
                            "successful_landings": 0,
                            "failed_landings": 0,
                            "attempted_landings": 0,
                            "successful_landings_spacecraft": 20,
                            "failed_landings_spacecraft": 0,
                            "attempted_landings_spacecraft": 20,
                            "successful_landings_payload": 0,
                            "failed_landings_payload": 0,
                            "attempted_landings_payload": 0,
                            "info_url": null,
                            "wiki_url": "https://en.wikipedia.org/wiki/North_American_Aviation",
                            "social_media_links": []
                        }
                    ],
                    "parent": null,
                    "description": "",
                    "active": false,
                    "maiden_flight": "1959-08-21",
                    "total_launch_count": 13,
                    "consecutive_successful_launches": 1,
                    "successful_launches": 7,
                    "failed_launches": 6,
                    "pending_launches": 0,
                    "attempted_landings": 0,
                    "successful_landings": 0,
                    "failed_landings": 0,
                    "consecutive_successful_landings": 0
                }
            ],
            "full_name": "Little Joe",
            "variant": "",
            "active": false,
            "is_placeholder": false,
            "program": [
                {
                    "response_mode": "normal",
                    "id": 2,
                    "url": "https://lldev.thespacedevs.com/2.3.0/programs/2/?format=api",
                    "name": "Mercury",
                    "image": {
                        "id": 1880,
                        "name": "[AUTO] Mercury - image",
                        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/project2520mer_program_20200820194755.png",
                        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194025.png",
                        "credit": null,
                        "license": {
                            "id": 1,
                            "name": "Unknown",
                            "priority": 9,
                            "link": null
                        },
                        "single_use": true,
                        "variants": []
                    },
                    "info_url": "https://www.nasa.gov/mission_pages/mercury/missions/program-toc.html",
                    "wiki_url": "https://en.wikipedia.org/wiki/Project_Mercury",
                    "description": "Project Mercury was the first human spaceflight program of the United States, running from 1958 through 1963.",
                    "agencies": [
                        {
                            "response_mode": "list",
                            "id": 44,
                            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/44/?format=api",
                            "name": "National Aeronautics and Space Administration",
                            "abbrev": "NASA",
                            "type": {
                                "id": 1,
                                "name": "Government"
                            }
                        }
                    ],
                    "start_date": "1958-10-07T00:00:00Z",
                    "end_date": "1963-05-16T23:24:02Z",
                    "mission_patches": [],
                    "type": {
                        "id": 2,
                        "name": "Human Spaceflight"
                    }
                }
            ],
            "reusable": false,
            "image": {
                "id": 1761,
                "name": "[AUTO] Little Joe - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/little_joe_image_20210901081353.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193708.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Little_Joe_(rocket)",
            "description": "Little Joe was a solid-fueled booster rocket used by NASA for eight launches from 1959-1960 from Wallops Island, Virginia to test the launch escape system and heat shield for Project Mercury capsules.",
            "alias": "",
            "min_stage": 1,
            "max_stage": 1,
            "length": 17.0,
            "diameter": null,
            "maiden_flight": "1959-08-21",
            "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": 8,
            "consecutive_successful_launches": 1,
            "successful_launches": 3,
            "failed_launches": 5,
            "pending_launches": 0,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0,
            "fastest_turnaround": "P30DT1H50M"
        },
        {
            "response_mode": "detailed",
            "id": 209,
            "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/209/?format=api",
            "name": "North American X-15",
            "families": [],
            "full_name": "North American X-15",
            "variant": "",
            "active": false,
            "is_placeholder": false,
            "program": [
                {
                    "response_mode": "normal",
                    "id": 20,
                    "url": "https://lldev.thespacedevs.com/2.3.0/programs/20/?format=api",
                    "name": "X-15",
                    "image": {
                        "id": 1897,
                        "name": "[AUTO] X-15 - image",
                        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/x-15_program_20210809102752.jpeg",
                        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194057.jpeg",
                        "credit": null,
                        "license": {
                            "id": 1,
                            "name": "Unknown",
                            "priority": 9,
                            "link": null
                        },
                        "single_use": true,
                        "variants": []
                    },
                    "info_url": null,
                    "wiki_url": "https://en.wikipedia.org/wiki/North_American_X-15",
                    "description": "Experimental hypersonic rocket-powered aircraft.",
                    "agencies": [
                        {
                            "response_mode": "list",
                            "id": 44,
                            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/44/?format=api",
                            "name": "National Aeronautics and Space Administration",
                            "abbrev": "NASA",
                            "type": {
                                "id": 1,
                                "name": "Government"
                            }
                        },
                        {
                            "response_mode": "list",
                            "id": 161,
                            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/161/?format=api",
                            "name": "United States Air Force",
                            "abbrev": "USAF",
                            "type": {
                                "id": 1,
                                "name": "Government"
                            }
                        }
                    ],
                    "start_date": "1959-03-10T00:00:00Z",
                    "end_date": "1968-12-12T00:00:00Z",
                    "mission_patches": [],
                    "type": {
                        "id": 2,
                        "name": "Human Spaceflight"
                    }
                }
            ],
            "reusable": true,
            "image": {
                "id": 1796,
                "name": "[AUTO] North American X-15 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/north_american__image_20210813101104.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193805.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/North_American_X-15",
            "description": "The North American X-15 was a hypersonic rocket-powered aircraft operated by the United States Air Force and the National Aeronautics and Space Administration as part of the X-plane series of experimental aircraft.",
            "alias": "",
            "min_stage": 1,
            "max_stage": 1,
            "length": 15.47,
            "diameter": 6.61,
            "maiden_flight": "1959-06-08",
            "launch_cost": null,
            "launch_mass": 15195.0,
            "leo_capacity": null,
            "gto_capacity": null,
            "geo_capacity": null,
            "sso_capacity": null,
            "to_thrust": 286.0,
            "apogee": 108.0,
            "total_launch_count": 13,
            "consecutive_successful_launches": 1,
            "successful_launches": 12,
            "failed_launches": 1,
            "pending_launches": 0,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0,
            "fastest_turnaround": "P16DT2H39M"
        }
    ],
    "spacecraft_list": [
        {
            "response_mode": "detailed",
            "id": 10,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/10/?format=api",
            "name": "Apollo Command/Service Module",
            "type": {
                "id": 2,
                "name": "Capsule"
            },
            "agency": {
                "response_mode": "normal",
                "id": 999,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/999/?format=api",
                "name": "North American Aviation",
                "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": "North American Aviation (NAA) was a major American aerospace manufacturer, responsible for a number of historic aircraft, including the T-6 Texan trainer, the P-51 Mustang fighter, the B-25 Mitchell bomber, the F-86 Sabre jet fighter, the X-15 rocket plane, and the XB-70, as well as Apollo command and service module, the second stage of the Saturn V rocket, the Space Shuttle orbiter and the B-1 Lancer.",
                "administrator": null,
                "founding_year": 1928,
                "launchers": "North American X-15",
                "spacecraft": "",
                "parent": "Boeing",
                "image": null,
                "logo": {
                    "id": 164,
                    "name": "[AUTO] North American Aviation - logo",
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/north2520american2520aviation_logo_20200711032022.png",
                    "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185049.png",
                    "credit": null,
                    "license": {
                        "id": 1,
                        "name": "Unknown",
                        "priority": 9,
                        "link": null
                    },
                    "single_use": true,
                    "variants": []
                },
                "social_logo": null
            },
            "family": [],
            "in_use": false,
            "image": {
                "id": 1902,
                "name": "[AUTO] Apollo Command/Service Module - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/apollo2520command2fservice2520module_image_20190207032507.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194107.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "capability": "Cargo and Human Transportation to Lunar Orbit",
            "history": "The Apollo Command/Service Module (CSM) was one of two principal components of the United States Apollo spacecraft, used for the Apollo program which landed astronauts on the Moon between 1969 and 1972.",
            "details": "The Apollo Command/Service Module (CSM) was one of two principal components of the United States Apollo spacecraft, used for the Apollo program which landed astronauts on the Moon between 1969 and 1972. The CSM functioned as a mother ship which carried a crew of three astronauts and the second Apollo spacecraft, the Lunar Module, to lunar orbit, and brought the astronauts back to Earth. It consisted of two parts: the conical Command Module, a cabin that housed the crew and carried equipment needed for atmospheric reentry and splashdown; and the cylindrical Service Module which provided propulsion, electrical power and storage for various consumables required during a mission. An umbilical connection transferred power and consumables between the two modules. Just before reentry of the Command Module on the return home, the umbilical connection was severed and the Service Module was cast off and allowed to burn up in the atmosphere.",
            "maiden_flight": "1966-02-26",
            "height": 11.0,
            "diameter": 3.9,
            "human_rated": true,
            "crew_capacity": 3,
            "payload_capacity": 1050,
            "payload_return_capacity": null,
            "flight_life": "14 days",
            "wiki_link": "https://en.wikipedia.org/wiki/Apollo_Command/Service_Module",
            "info_link": "",
            "spacecraft_flown": 21,
            "total_launch_count": 21,
            "successful_launches": 19,
            "failed_launches": 2,
            "attempted_landings": 20,
            "successful_landings": 20,
            "failed_landings": 0,
            "fastest_turnaround": null
        }
    ]
}