Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: TheSpaceDevs LL2 Families 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: Families
paths:
/2.3.0/launcher_configuration_families/:
get:
operationId: launcher_configuration_families_list
summary: List Launcher Configuration Families
description: '#### Modes
Levels of detail in the response - `list`, `normal`, `detailed`
Example - [/launcher_configuration_families/?mode=list](./?mode=list)
#### Filters
Parameters - `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`, `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`, `maiden_flight`, `maiden_flight__gt`, `maiden_flight__gte`, `maiden_flight__lt`, `maiden_flight__lte`, `manufacturer__abbrev`, `manufacturer__abbrev__contains`, `manufacturer__country_code`, `manufacturer__id`, `manufacturer__id__contains`, `manufacturer__name`, `manufacturer__name__contains`, `name`, `name__contains`, `pending_launches`, `pending_launches__gt`, `pending_launches__gte`, `pending_launches__lt`, `pending_launches__lte`, `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`
Example - [/launcher_configuration_families/?manufacturer__name=SpaceX](./?manufacturer__name=SpaceX)
#### Search
Fields searched - `manufacturer__abbrev`, `manufacturer__name`, `name`
Example - [/launcher_configuration_families/?search=Ariane](./?search=Ariane)
#### Ordering
Fields - `attempted_landings`, `consecutive_successful_landings`, `consecutive_successful_launches`, `failed_landings`, `failed_launches`, `name`, `pending_launches`, `successful_landings`, `successful_launches`, `total_launch_count`
Example - [/launcher_configuration_families/?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 - [/launcher_configuration_families/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/launcher_configuration_families/?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: 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: 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
- name: limit
required: false
in: query
description: Number of results to return per page.
schema:
type: integer
- in: query
name: maiden_flight
schema:
type: string
format: date
- in: query
name: maiden_flight__gt
schema:
type: string
format: date
- in: query
name: maiden_flight__gte
schema:
type: string
format: date
- in: query
name: maiden_flight__lt
schema:
type: string
format: date
- in: query
name: maiden_flight__lte
schema:
type: string
format: date
- in: query
name: manufacturer__abbrev
schema:
type: string
- in: query
name: manufacturer__abbrev__contains
schema:
type: string
- in: query
name: manufacturer__country_code
schema:
type: string
- in: query
name: manufacturer__id
schema:
type: integer
- in: query
name: manufacturer__id__contains
schema:
type: integer
- in: query
name: manufacturer__name
schema:
type: string
- in: query
name: manufacturer__name__contains
schema:
type: string
- 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: 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: 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
tags:
- Families
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedPolymorphicLauncherConfigFamilyEndpointList'
description: ''
/2.3.0/launcher_configuration_families/{id}/:
get:
operationId: launcher_configuration_families_retrieve
summary: Get Launcher Configuration Family
description: '#### Modes
Levels of detail in the response - `list`, `normal`, `detailed`
Example - [/launcher_configuration_families/?mode=list](./?mode=list)
#### Filters
Parameters - `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`, `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`, `maiden_flight`, `maiden_flight__gt`, `maiden_flight__gte`, `maiden_flight__lt`, `maiden_flight__lte`, `manufacturer__abbrev`, `manufacturer__abbrev__contains`, `manufacturer__country_code`, `manufacturer__id`, `manufacturer__id__contains`, `manufacturer__name`, `manufacturer__name__contains`, `name`, `name__contains`, `pending_launches`, `pending_launches__gt`, `pending_launches__gte`, `pending_launches__lt`, `pending_launches__lte`, `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`
Example - [/launcher_configuration_families/?manufacturer__name=SpaceX](./?manufacturer__name=SpaceX)
#### Search
Fields searched - `manufacturer__abbrev`, `manufacturer__name`, `name`
Example - [/launcher_configuration_families/?search=Ariane](./?search=Ariane)
#### Ordering
Fields - `attempted_landings`, `consecutive_successful_landings`, `consecutive_successful_launches`, `failed_landings`, `failed_launches`, `name`, `pending_launches`, `successful_landings`, `successful_launches`, `total_launch_count`
Example - [/launcher_configuration_families/?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 - [/launcher_configuration_families/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/launcher_configuration_families/?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 Launcher Configuration Family.
required: true
tags:
- Families
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/LauncherConfigFamilyDetailed'
description: ''
/2.3.0/spacecraft_configuration_families/:
get:
operationId: spacecraft_configuration_families_list
summary: List Spacecraft Configuration Families
description: '#### Modes
Levels of detail in the response - `list`, `normal`, `detailed`
Example - [/spacecraft_configuration_families/?mode=list](./?mode=list)
#### Filters
Parameters - `manufacturer`, `name`
Example - [/spacecraft_configuration_families/?manufacturer=121](./?manufacturer=121)
#### Search
Fields searched - `manufacturer__abbrev`, `manufacturer__name`, `name`
Example - [/spacecraft_configuration_families/?search=Northrop](./?search=Northrop)
#### Ordering
Fields - `name`
Example - [/spacecraft_configuration_families/?ordering=name](./?ordering=name)
#### Number of results
Use `limit` to control the number of objects in the response (max 100)
Example - [/spacecraft_configuration_families/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/spacecraft_configuration_families/?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:
- name: limit
required: false
in: query
description: Number of results to return per page.
schema:
type: integer
- in: query
name: manufacturer
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
- 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
- name: search
required: false
in: query
description: A search term.
schema:
type: string
tags:
- Families
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedPolymorphicSpacecraftConfigFamilyEndpointList'
description: ''
/2.3.0/spacecraft_configuration_families/{id}/:
get:
operationId: spacecraft_configuration_families_retrieve
summary: Get Spacecraft Configuration Family
description: '#### Modes
Levels of detail in the response - `list`, `normal`, `detailed`
Example - [/spacecraft_configuration_families/?mode=list](./?mode=list)
#### Filters
Parameters - `manufacturer`, `name`
Example - [/spacecraft_configuration_families/?manufacturer=121](./?manufacturer=121)
#### Search
Fields searched - `manufacturer__abbrev`, `manufacturer__name`, `name`
Example - [/spacecraft_configuration_families/?search=Northrop](./?search=Northrop)
#### Ordering
Fields - `name`
Example - [/spacecraft_configuration_families/?ordering=name](./?ordering=name)
#### Number of results
Use `limit` to control the number of objects in the response (max 100)
Example - [/spacecraft_configuration_families/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/spacecraft_configuration_families/?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 Spacecraft Configuration Family.
required: true
tags:
- Families
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/SpacecraftConfigFamilyEndpointDetailed'
description: ''
components:
schemas:
AgencyType:
type: object
properties:
id:
type: integer
maximum: 2147483647
minimum: -2147483648
name:
type: string
maxLength: 255
required:
- id
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
SpacecraftConfigNormal:
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: 200
type:
$ref: '#/components/schemas/SpacecraftConfigType'
agency:
$ref: '#/components/schemas/AgencyMini'
family:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/SpacecraftConfigFamilyNormal'
in_use:
type: boolean
image:
allOf:
- $ref: '#/components/schemas/Image'
required:
- agency
- family
- id
- image
- name
- response_mode
- type
- url
SpacecraftConfigFamilyEndpointDetailed:
type: object
properties:
response_mode:
type: string
readOnly: true
default: detailed
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
spacecraft:
type: array
items:
$ref: '#/components/schemas/SpacecraftConfigNormal'
required:
- id
- manufacturer
- name
- parent
- response_mode
- spacecraft
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
PaginatedPolymorphicSpacecraftConfigFamilyEndpointList:
type: object
required:
- count
- results
properties:
count:
type: integer
example: 123
next:
type:
- string
- 'null'
format: uri
example: http://api.example.org/accounts/?offset=400&limit=100
previous:
type:
- string
- 'null'
format: uri
example: http://api.example.org/accounts/?offset=200&limit=100
results:
type: array
items:
$ref: '#/components/schemas/PolymorphicSpacecraftConfigFamilyEndpoint'
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
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
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
PolymorphicSpacecraftConfigFamilyEndpoint:
oneOf:
- $ref: '#/components/schemas/SpacecraftConfigFamilyMini'
- $ref: '#/components/schemas/SpacecraftConfigFamilyNormal'
- $ref: '#/components/schemas/SpacecraftConfigFamilyEndpointDetailed'
discriminator:
propertyName: response_mode
mapping:
list: '#/components/schemas/SpacecraftConfigFamilyMini'
normal: '#/components/schemas/SpacecraftConfigFamilyNormal'
detailed: '#/components/schemas/SpacecraftConfigFamilyEndpointDetailed'
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
PaginatedPolymorphicLauncherConfigFamilyEndpointList:
type: object
required:
- count
- results
properties:
count:
type: integer
example: 123
next:
type:
- string
- 'null'
format: uri
example: http://api.example.org/accounts/?offset=400&limit=100
previous:
type:
- string
- 'null'
format: uri
example: http://api.example.org/accounts/?offset=200&limit=100
results:
type: array
items:
$ref: '#/components/schemas/PolymorphicLauncherConfigFamilyEndpoint'
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
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
AgencyDetailed:
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: 200
abbrev:
type: string
maxLength: 255
type:
$ref: '#/components/schemas/AgencyType'
featured:
type: boolean
country:
type: array
items:
$ref: '#/components/schemas/Country'
description:
type:
- string
- 'null'
maxLength: 2048
administrator:
type:
- string
- 'null'
maxLength: 200
founding_year:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
launchers:
type: string
maxLength: 500
spacecraft:
type: string
maxLength: 500
parent:
type:
- string
- 'null'
readOnly: true
image:
allOf:
- $ref: '#/components/sch
# --- truncated at 32 KB (37 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/thespacedevs-ll2-api/refs/heads/main/openapi/thespacedevs-ll2-api-families-api-openapi.yml