GET

Agency Instance

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

{
    "response_mode": "detailed",
    "id": 183,
    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/183/?format=api",
    "name": "Unknown",
    "abbrev": "UNK",
    "type": {
        "id": 6,
        "name": "Unknown"
    },
    "featured": false,
    "country": [
        {
            "id": 17,
            "name": "Unknown",
            "alpha_2_code": "??",
            "alpha_3_code": "???",
            "nationality_name": "Earthling",
            "nationality_name_composed": "Earthling"
        }
    ],
    "description": "The agency or launch service provider is not known yet.",
    "administrator": null,
    "founding_year": null,
    "launchers": "",
    "spacecraft": "",
    "parent": null,
    "image": null,
    "logo": null,
    "social_logo": {
        "id": 2048,
        "name": "Unknown Agency Question Mark Social Logo",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/unknown_agency__image_20240409102110.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/unknown_agency__image_thumbnail_20240409102110.jpeg",
        "credit": "TheSpaceDevs",
        "license": {
            "id": 1,
            "name": "Unknown",
            "priority": 9,
            "link": null
        },
        "single_use": true,
        "variants": []
    },
    "total_launch_count": 0,
    "consecutive_successful_launches": 0,
    "successful_launches": 0,
    "failed_launches": 0,
    "pending_launches": 3,
    "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/",
    "social_media_links": [],
    "launcher_list": [
        {
            "response_mode": "detailed",
            "id": 511,
            "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/511/?format=api",
            "name": "Unknown Launch Vehicle",
            "families": [],
            "full_name": "Unknown Launch Vehicle",
            "variant": "",
            "active": true,
            "is_placeholder": true,
            "program": [],
            "reusable": false,
            "image": null,
            "info_url": null,
            "wiki_url": null,
            "description": "",
            "alias": "",
            "min_stage": null,
            "max_stage": null,
            "length": null,
            "diameter": null,
            "maiden_flight": null,
            "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": 0,
            "consecutive_successful_launches": 0,
            "successful_launches": 0,
            "failed_launches": 0,
            "pending_launches": 3,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0,
            "fastest_turnaround": null
        }
    ],
    "spacecraft_list": []
}