Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: TheSpaceDevs LL2 Agencies API
version: v2.3.0
description: Rocket launches, space events and crewed spaceflight. The Launch Library 2 API is the official successor of the popular Launch Library API. It keeps its core features whilst also including everything the broader Space Launch Now API had to offer. The result is a large database delivering a more complete experience for each rocket launch and ...
license:
name: Apache License 2.0
servers:
- url: https://ll.thespacedevs.com/
description: Production API (� rate-limited)
- url: https://lldev.thespacedevs.com/
description: Development API (stale and limited data, for development testing only)
tags:
- name: Agencies
paths:
/2.3.0/agencies/:
get:
operationId: agencies_list
summary: List Agencies
description: '#### Modes
Levels of detail in the response - `list`, `normal`, `detailed`
Example - [/agencies/?mode=list](./?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](./?abbrev=NASA)
#### Search
Fields searched - `abbrev`, `name`
Example - [/agencies/?search=SpaceX](./?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](./?ordering=-total_launch_count)
#### Number of results
Use `limit` to control the number of objects in the response (max 100)
Example - [/agencies/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/agencies/?format=json](./?format=json)
#### Help
Find all the FAQs and support links on the documentation homepage - [ll.thespacedevs.com/docs](https://ll.thespacedevs.com/docs/)'
parameters:
- in: query
name: abbrev
schema:
type: string
- in: query
name: abbrev__contains
schema:
type: string
- in: query
name: attempted_landings
schema:
type: integer
- in: query
name: attempted_landings__gt
schema:
type: integer
- in: query
name: attempted_landings__gte
schema:
type: integer
- in: query
name: attempted_landings__lt
schema:
type: integer
- in: query
name: attempted_landings__lte
schema:
type: integer
- in: query
name: consecutive_successful_landings
schema:
type: integer
- in: query
name: consecutive_successful_landings__gt
schema:
type: integer
- in: query
name: consecutive_successful_landings__gte
schema:
type: integer
- in: query
name: consecutive_successful_landings__lt
schema:
type: integer
- in: query
name: consecutive_successful_landings__lte
schema:
type: integer
- in: query
name: consecutive_successful_launches
schema:
type: integer
- in: query
name: consecutive_successful_launches__gt
schema:
type: integer
- in: query
name: consecutive_successful_launches__gte
schema:
type: integer
- in: query
name: consecutive_successful_launches__lt
schema:
type: integer
- in: query
name: consecutive_successful_launches__lte
schema:
type: integer
- in: query
name: country_code
schema:
type: array
items:
type: string
description: Multiple values may be separated by commas.
explode: false
style: form
- in: query
name: description
schema:
type: string
- in: query
name: description__contains
schema:
type: string
- in: query
name: failed_landings
schema:
type: integer
- in: query
name: failed_landings__gt
schema:
type: integer
- in: query
name: failed_landings__gte
schema:
type: integer
- in: query
name: failed_landings__lt
schema:
type: integer
- in: query
name: failed_landings__lte
schema:
type: integer
- in: query
name: failed_launches
schema:
type: integer
- in: query
name: failed_launches__gt
schema:
type: integer
- in: query
name: failed_launches__gte
schema:
type: integer
- in: query
name: failed_launches__lt
schema:
type: integer
- in: query
name: failed_launches__lte
schema:
type: integer
- in: query
name: featured
schema:
type: boolean
- in: query
name: founding_year
schema:
type: integer
- in: query
name: founding_year__gt
schema:
type: integer
- in: query
name: founding_year__gte
schema:
type: integer
- in: query
name: founding_year__lt
schema:
type: integer
- in: query
name: founding_year__lte
schema:
type: integer
- in: query
name: id
schema:
type: integer
- name: limit
required: false
in: query
description: Number of results to return per page.
schema:
type: integer
- in: query
name: mode
schema:
type: string
enum:
- detailed
- list
- normal
description: Level of detail in the response.
- in: query
name: name
schema:
type: string
- in: query
name: name__contains
schema:
type: string
- name: offset
required: false
in: query
description: The initial index from which to return the results.
schema:
type: integer
- name: ordering
required: false
in: query
description: Which field to use when ordering the results.
schema:
type: string
- in: query
name: parent__id
schema:
type: integer
- in: query
name: pending_launches
schema:
type: integer
- in: query
name: pending_launches__gt
schema:
type: integer
- in: query
name: pending_launches__gte
schema:
type: integer
- in: query
name: pending_launches__lt
schema:
type: integer
- in: query
name: pending_launches__lte
schema:
type: integer
- name: search
required: false
in: query
description: A search term.
schema:
type: string
- in: query
name: spacecraft
schema:
type: boolean
- in: query
name: successful_landings
schema:
type: integer
- in: query
name: successful_landings__gt
schema:
type: integer
- in: query
name: successful_landings__gte
schema:
type: integer
- in: query
name: successful_landings__lt
schema:
type: integer
- in: query
name: successful_landings__lte
schema:
type: integer
- in: query
name: successful_launches
schema:
type: integer
- in: query
name: successful_launches__gt
schema:
type: integer
- in: query
name: successful_launches__gte
schema:
type: integer
- in: query
name: successful_launches__lt
schema:
type: integer
- in: query
name: successful_launches__lte
schema:
type: integer
- in: query
name: total_launch_count
schema:
type: integer
- in: query
name: total_launch_count__gt
schema:
type: integer
- in: query
name: total_launch_count__gte
schema:
type: integer
- in: query
name: total_launch_count__lt
schema:
type: integer
- in: query
name: total_launch_count__lte
schema:
type: integer
- in: query
name: type__id
schema:
type: integer
tags:
- Agencies
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedPolymorphicAgencyEndpointList'
description: ''
/2.3.0/agencies/{id}/:
get:
operationId: agencies_retrieve
summary: Get Agency
description: '#### Modes
Levels of detail in the response - `list`, `normal`, `detailed`
Example - [/agencies/?mode=list](./?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](./?abbrev=NASA)
#### Search
Fields searched - `abbrev`, `name`
Example - [/agencies/?search=SpaceX](./?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](./?ordering=-total_launch_count)
#### Number of results
Use `limit` to control the number of objects in the response (max 100)
Example - [/agencies/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/agencies/?format=json](./?format=json)
#### Help
Find all the FAQs and support links on the documentation homepage - [ll.thespacedevs.com/docs](https://ll.thespacedevs.com/docs/)'
parameters:
- in: path
name: id
schema:
type: integer
description: A unique integer value identifying this Agency.
required: true
tags:
- Agencies
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/AgencyEndpointDetailed'
description: ''
components:
schemas:
ImageLicense:
type: object
properties:
id:
type: integer
readOnly: true
name:
type: string
maxLength: 255
priority:
type: integer
maximum: 2147483647
minimum: -2147483648
link:
type:
- string
- 'null'
format: uri
maxLength: 200
required:
- id
AgencyType:
type: object
properties:
id:
type: integer
maximum: 2147483647
minimum: -2147483648
name:
type: string
maxLength: 255
required:
- id
SpacecraftConfigFamilyMini:
type: object
properties:
response_mode:
type: string
readOnly: true
default: list
id:
type: integer
readOnly: true
name:
type: string
maxLength: 200
required:
- id
- name
- response_mode
SocialMediaLink:
type: object
properties:
id:
type: integer
readOnly: true
social_media:
$ref: '#/components/schemas/SocialMedia'
url:
type:
- string
- 'null'
format: uri
required:
- id
- social_media
- url
LauncherConfigFamilyDetailed:
type: object
properties:
response_mode:
type: string
readOnly: true
default: detailed
id:
type: integer
readOnly: true
name:
type: string
maxLength: 200
manufacturer:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/AgencyDetailed'
parent:
allOf:
- $ref: '#/components/schemas/LauncherConfigFamilyNormal'
description:
type: string
maxLength: 2048
active:
type: boolean
maiden_flight:
type:
- string
- 'null'
format: date
title: Maiden Flight Date
total_launch_count:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
consecutive_successful_launches:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
successful_launches:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
failed_launches:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
pending_launches:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
attempted_landings:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
successful_landings:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
failed_landings:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
consecutive_successful_landings:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
required:
- id
- manufacturer
- name
- parent
- response_mode
AgencyMini:
type: object
properties:
response_mode:
type: string
readOnly: true
default: list
id:
type: integer
readOnly: true
url:
type: string
format: uri
readOnly: true
name:
type: string
maxLength: 200
abbrev:
type: string
maxLength: 255
type:
$ref: '#/components/schemas/AgencyType'
required:
- id
- name
- response_mode
- type
- url
SpacecraftConfigFamilyDetailed:
type: object
properties:
response_mode:
type: string
readOnly: true
default: normal
id:
type: integer
readOnly: true
name:
type: string
maxLength: 200
description:
type: string
maxLength: 2048
manufacturer:
$ref: '#/components/schemas/AgencyNormal'
parent:
allOf:
- $ref: '#/components/schemas/SpacecraftConfigFamilyNormal'
maiden_flight:
type:
- string
- 'null'
format: date
title: Maiden Flight Date
spacecraft_flown:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
total_launch_count:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
successful_launches:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
failed_launches:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
attempted_landings:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
successful_landings:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
failed_landings:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
required:
- id
- manufacturer
- name
- parent
- response_mode
PolymorphicAgencyEndpoint:
oneOf:
- $ref: '#/components/schemas/AgencyMini'
- $ref: '#/components/schemas/AgencyNormal'
- $ref: '#/components/schemas/AgencyEndpointDetailed'
discriminator:
propertyName: response_mode
mapping:
list: '#/components/schemas/AgencyMini'
normal: '#/components/schemas/AgencyNormal'
detailed: '#/components/schemas/AgencyEndpointDetailed'
LauncherConfigFamilyMini:
type: object
properties:
response_mode:
type: string
readOnly: true
default: list
id:
type: integer
readOnly: true
name:
type: string
maxLength: 200
required:
- id
- name
- response_mode
MissionPatch:
type: object
properties:
id:
type: integer
readOnly: true
name:
type: string
maxLength: 200
priority:
type: integer
maximum: 2147483647
minimum: -2147483648
image_url:
type: string
format: uri
agency:
allOf:
- $ref: '#/components/schemas/AgencyMini'
response_mode:
type: string
readOnly: true
default: normal
required:
- agency
- id
- image_url
- name
- response_mode
SpacecraftConfigDetailed:
type: object
properties:
response_mode:
type: string
readOnly: true
default: detailed
id:
type: integer
readOnly: true
url:
type: string
format: uri
readOnly: true
name:
type: string
maxLength: 200
type:
$ref: '#/components/schemas/SpacecraftConfigType'
agency:
$ref: '#/components/schemas/AgencyNormal'
family:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/SpacecraftConfigFamilyDetailed'
in_use:
type: boolean
image:
allOf:
- $ref: '#/components/schemas/Image'
capability:
type: string
maxLength: 2048
history:
type: string
maxLength: 1000
details:
type: string
maxLength: 1000
maiden_flight:
type:
- string
- 'null'
format: date
height:
type:
- number
- 'null'
format: double
title: Length (m)
diameter:
type:
- number
- 'null'
format: double
title: Diameter (m)
human_rated:
type: boolean
crew_capacity:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
payload_capacity:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
title: Payload Capacity (kg)
payload_return_capacity:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
title: Payload Return Capacity (kg)
flight_life:
type:
- string
- 'null'
maxLength: 2048
wiki_link:
type: string
format: uri
maxLength: 200
info_link:
type: string
format: uri
maxLength: 200
spacecraft_flown:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
total_launch_count:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
successful_launches:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
failed_launches:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
attempted_landings:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
successful_landings:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
failed_landings:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
fastest_turnaround:
type:
- string
- 'null'
readOnly: true
required:
- agency
- family
- fastest_turnaround
- id
- image
- name
- response_mode
- type
- url
Image:
type: object
properties:
id:
type: integer
readOnly: true
name:
type: string
maxLength: 255
image_url:
type: string
format: uri
thumbnail_url:
type: string
format: uri
credit:
type:
- string
- 'null'
maxLength: 255
license:
$ref: '#/components/schemas/ImageLicense'
single_use:
type: boolean
variants:
type: array
items:
$ref: '#/components/schemas/ImageVariant'
required:
- id
- image_url
- license
- name
- thumbnail_url
- variants
Country:
type: object
properties:
id:
type: integer
readOnly: true
name:
type: string
maxLength: 255
alpha_2_code:
type: string
description: ISO 3166-1 alpha-2
maxLength: 2
alpha_3_code:
type: string
description: ISO 3166-1 alpha-3
maxLength: 3
nationality_name:
type: string
description: e.g. French
maxLength: 255
nationality_name_composed:
type: string
description: e.g. Franco
maxLength: 255
required:
- id
SpacecraftConfigType:
type: object
properties:
id:
type: integer
readOnly: true
name:
type: string
maxLength: 255
required:
- id
- name
LauncherConfigFamilyNormal:
type: object
properties:
response_mode:
type: string
readOnly: true
default: normal
id:
type: integer
readOnly: true
name:
type: string
maxLength: 200
manufacturer:
type: array
items:
$ref: '#/components/schemas/AgencyNormal'
parent:
allOf:
- $ref: '#/components/schemas/LauncherConfigFamilyMini'
required:
- id
- manufacturer
- name
- parent
- response_mode
SpacecraftConfigFamilyNormal:
type: object
properties:
response_mode:
type: string
readOnly: true
default: normal
id:
type: integer
readOnly: true
name:
type: string
maxLength: 200
description:
type: string
maxLength: 2048
manufacturer:
allOf:
- $ref: '#/components/schemas/AgencyMini'
parent:
allOf:
- $ref: '#/components/schemas/SpacecraftConfigFamilyMini'
maiden_flight:
type:
- string
- 'null'
format: date
title: Maiden Flight Date
required:
- id
- manufacturer
- name
- parent
- response_mode
ProgramNormal:
type: object
properties:
response_mode:
type: string
readOnly: true
default: normal
id:
type: integer
readOnly: true
url:
type: string
format: uri
readOnly: true
name:
type: string
maxLength: 255
image:
allOf:
- $ref: '#/components/schemas/Image'
info_url:
type:
- string
- 'null'
format: uri
maxLength: 200
wiki_url:
type:
- string
- 'null'
format: uri
maxLength: 200
description:
type:
- string
- 'null'
maxLength: 40000
agencies:
type: array
items:
$ref: '#/components/schemas/AgencyMini'
start_date:
type:
- string
- 'null'
format: date-time
end_date:
type:
- string
- 'null'
format: date-time
mission_patches:
type: array
items:
$ref: '#/components/schemas/MissionPatch'
type:
$ref: '#/components/schemas/ProgramType'
required:
- agencies
- id
- image
- mission_patches
- name
- response_mode
- type
- url
ProgramType:
type: object
properties:
id:
type: integer
maximum: 2147483647
minimum: -2147483648
name:
type: string
maxLength: 255
required:
- id
ImageVariant:
type: object
properties:
id:
type: integer
readOnly: true
type:
$ref: '#/components/schemas/ImageVariantType'
image_url:
type: string
format: uri
required:
- id
- image_url
- type
LauncherConfigDetailedSerializerNoManufacturer:
type: object
properties:
response_mode:
type: string
readOnly: true
default: detailed
id:
type: integer
readOnly: true
url:
type: string
format: uri
readOnly: true
name:
type: string
maxLength: 200
families:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/LauncherConfigFamilyDetailed'
full_name:
type: string
maxLength: 200
variant:
type: string
maxLength: 200
active:
type: boolean
is_placeholder:
type: boolean
program:
type: array
items:
$ref: '#/components/schemas/ProgramNormal'
reusable:
type: boolean
image:
allOf:
- $ref: '#/components/schemas/Image'
info_url:
type:
- string
- 'null'
maxLength: 200
wiki_url:
type:
- string
- 'null'
maxLength: 200
description:
type: string
maxLength: 2048
alias:
type: string
maxLength: 200
min_stage:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
max_stage:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
length:
type:
- number
- 'null'
format: double
title: Length (m)
diameter:
type:
- number
- 'null'
format: double
title: Max Diameter (m)
maiden_flight:
type:
- string
- 'null'
format: date
title: Maiden Flight Date
launch_cost:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
title: Launch Cost (USD)
launch_mass:
type:
- number
- 'null'
format: double
title: Mass at Launch (T)
leo_capacity:
type:
- number
- 'null'
format: double
title: LEO Capacity (kg)
gto_capacity:
type:
- number
- 'null'
format: double
title: GTO Capacity (kg)
geo_capacity:
type:
- number
- 'null'
format: double
title: GEO Capacity (kg)
sso_capacity:
type:
- number
- 'null'
format: double
title: SSO Capacity (kg)
to_thrust:
type:
- number
- 'null'
format: double
title: Thrust at Liftoff (kN)
apogee:
type:
- number
- 'null'
# --- truncated at 32 KB (45 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/thespacedevs-ll2-api/refs/heads/main/openapi/thespacedevs-ll2-api-agencies-api-openapi.yml