openapi: 3.0.3
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:
SocialMedia:
type: object
properties:
id:
type: integer
readOnly: true
name:
type: string
maxLength: 255
url:
type: string
format: uri
nullable: true
logo:
allOf:
- $ref: '#/components/schemas/Image'
nullable: true
required:
- id
- logo
- url
SpacecraftConfigType:
type: object
properties:
id:
type: integer
readOnly: true
name:
type: string
maxLength: 255
required:
- id
- name
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
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
items:
$ref: '#/components/schemas/SpacecraftConfigFamilyNormal'
nullable: true
in_use:
type: boolean
image:
allOf:
- $ref: '#/components/schemas/Image'
nullable: true
required:
- agency
- family
- id
- image
- name
- response_mode
- type
- url
PolymorphicLauncherConfigFamilyEndpoint:
oneOf:
- $ref: '#/components/schemas/LauncherConfigFamilyMini'
- $ref: '#/components/schemas/LauncherConfigFamilyNormal'
- $ref: '#/components/schemas/LauncherConfigFamilyDetailed'
discriminator:
propertyName: response_mode
mapping:
list: '#/components/schemas/LauncherConfigFamilyMini'
normal: '#/components/schemas/LauncherConfigFamilyNormal'
detailed: '#/components/schemas/LauncherConfigFamilyDetailed'
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'
nullable: true
maiden_flight:
type: string
format: date
nullable: true
title: Maiden Flight Date
spacecraft_flown:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
total_launch_count:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
successful_launches:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
failed_launches:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
attempted_landings:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
successful_landings:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
failed_landings:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
spacecraft:
type: array
items:
$ref: '#/components/schemas/SpacecraftConfigNormal'
required:
- id
- manufacturer
- name
- parent
- response_mode
- spacecraft
ImageLicense:
type: object
properties:
id:
type: integer
readOnly: true
name:
type: string
maxLength: 255
priority:
type: integer
maximum: 2147483647
minimum: -2147483648
link:
type: string
format: uri
nullable: true
maxLength: 200
required:
- id
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
PaginatedPolymorphicLauncherConfigFamilyEndpointList:
type: object
required:
- count
- results
properties:
count:
type: integer
example: 123
next:
type: string
nullable: true
format: uri
example: http://api.example.org/accounts/?offset=400&limit=100
previous:
type: string
nullable: true
format: uri
example: http://api.example.org/accounts/?offset=200&limit=100
results:
type: array
items:
$ref: '#/components/schemas/PolymorphicLauncherConfigFamilyEndpoint'
PaginatedPolymorphicSpacecraftConfigFamilyEndpointList:
type: object
required:
- count
- results
properties:
count:
type: integer
example: 123
next:
type: string
nullable: true
format: uri
example: http://api.example.org/accounts/?offset=400&limit=100
previous:
type: string
nullable: true
format: uri
example: http://api.example.org/accounts/?offset=200&limit=100
results:
type: array
items:
$ref: '#/components/schemas/PolymorphicSpacecraftConfigFamilyEndpoint'
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
nullable: true
maxLength: 2048
administrator:
type: string
nullable: true
maxLength: 200
founding_year:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
launchers:
type: string
maxLength: 500
spacecraft:
type: string
maxLength: 500
parent:
type: string
readOnly: true
nullable: true
image:
allOf:
- $ref: '#/components/schemas/Image'
nullable: true
logo:
allOf:
- $ref: '#/components/schemas/Image'
nullable: true
social_logo:
allOf:
- $ref: '#/components/schemas/Image'
nullable: true
total_launch_count:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
consecutive_successful_launches:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
successful_launches:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
failed_launches:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
pending_launches:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
consecutive_successful_landings:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
successful_landings:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
failed_landings:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
attempted_landings:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
successful_landings_spacecraft:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
failed_landings_spacecraft:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
attempted_landings_spacecraft:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
successful_landings_payload:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
failed_landings_payload:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
attempted_landings_payload:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
info_url:
type: string
format: uri
nullable: true
maxLength: 200
wiki_url:
type: string
format: uri
nullable: true
maxLength: 200
social_media_links:
type: array
items:
$ref: '#/components/schemas/SocialMediaLink'
required:
- country
- id
- image
- logo
- name
- parent
- response_mode
- social_logo
- social_media_links
- type
- url
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
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'
AgencyNormal:
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
nullable: true
maxLength: 2048
administrator:
type: string
nullable: true
maxLength: 200
founding_year:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
launchers:
type: string
maxLength: 500
spacecraft:
type: string
maxLength: 500
parent:
type: string
readOnly: true
nullable: true
image:
allOf:
- $ref: '#/components/schemas/Image'
nullable: true
logo:
allOf:
- $ref: '#/components/schemas/Image'
nullable: true
social_logo:
allOf:
- $ref: '#/components/schemas/Image'
nullable: true
required:
- country
- id
- image
- logo
- name
- parent
- response_mode
- social_logo
- type
- url
LauncherConfigFamilyDetailed:
type: object
properties:
# --- 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