openapi: 3.0.3
info:
title: TheSpaceDevs LL2 Events 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: Events
paths:
/2.3.0/config/timeline_event_types/:
get:
operationId: config_timeline_event_types_list
description: '#### Number of results
Use `limit` to control the number of objects in the response (max 100)
Example - [/config/timeline_event_types/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/config/timeline_event_types/?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
- 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:
- Events
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedTimelineEventTypeList'
description: ''
/2.3.0/config/timeline_event_types/{id}/:
get:
operationId: config_timeline_event_types_retrieve
description: '#### Number of results
Use `limit` to control the number of objects in the response (max 100)
Example - [/config/timeline_event_types/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/config/timeline_event_types/?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 Timeline Event Type.
required: true
tags:
- Events
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/TimelineEventType'
description: ''
/2.3.0/docking_events/:
get:
operationId: docking_events_list
summary: List Docking Events
description: '#### Modes
Levels of detail in the response - `normal`, `detailed`
Example - [/docking_events/?mode=detailed](./?mode=detailed)
#### Filters
Parameters - `docking__gt`, `docking__gte`, `docking__lt`, `docking__lte`, `docking_location__id`, `flight_vehicle_chaser__id`, `space_station_target__id`
Example - [/docking_events/?space_station_target__id=6](./?space_station_target__id=6)
#### Search
Fields searched - `docking_location__name`, `flight_vehicle_chaser__spacecraft__name`, `flight_vehicle_target__spacecraft__name`, `payload_flight_chaser__payload__name`, `payload_flight_target__payload__name`, `space_station_chaser__name`, `space_station_target__name`
Example - [/docking_events/?search=Salyut](./?search=Salyut)
#### Ordering
Fields - `departure`, `docking`
Example - [/docking_events/?ordering=-docking](./?ordering=-docking)
#### Number of results
Use `limit` to control the number of objects in the response (max 100)
Example - [/docking_events/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/docking_events/?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: docking__gt
schema:
type: string
format: date-time
description: Docking is greater than
- in: query
name: docking__gte
schema:
type: string
format: date-time
description: Docking is greater than or equal to
- in: query
name: docking__lt
schema:
type: string
format: date-time
description: Docking is less than
- in: query
name: docking__lte
schema:
type: string
format: date-time
description: Docking is less than or equal to
- in: query
name: docking_location__id
schema:
type: integer
- in: query
name: flight_vehicle_chaser__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
- normal
description: Level of detail in the response.
- 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
- in: query
name: space_station_target__id
schema:
type: integer
tags:
- Events
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedPolymorphicDockingEventEndpointList'
description: ''
/2.3.0/docking_events/{id}/:
get:
operationId: docking_events_retrieve
summary: Get Docking Event
description: '#### Modes
Levels of detail in the response - `normal`, `detailed`
Example - [/docking_events/?mode=detailed](./?mode=detailed)
#### Filters
Parameters - `docking__gt`, `docking__gte`, `docking__lt`, `docking__lte`, `docking_location__id`, `flight_vehicle_chaser__id`, `space_station_target__id`
Example - [/docking_events/?space_station_target__id=6](./?space_station_target__id=6)
#### Search
Fields searched - `docking_location__name`, `flight_vehicle_chaser__spacecraft__name`, `flight_vehicle_target__spacecraft__name`, `payload_flight_chaser__payload__name`, `payload_flight_target__payload__name`, `space_station_chaser__name`, `space_station_target__name`
Example - [/docking_events/?search=Salyut](./?search=Salyut)
#### Ordering
Fields - `departure`, `docking`
Example - [/docking_events/?ordering=-docking](./?ordering=-docking)
#### Number of results
Use `limit` to control the number of objects in the response (max 100)
Example - [/docking_events/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/docking_events/?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 docking event.
required: true
tags:
- Events
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/DockingEventEndpointDetailed'
description: ''
/2.3.0/events/:
get:
operationId: events_list
summary: List Events
description: '#### Modes
Levels of detail in the response - `list`, `normal`, `detailed`
Example - [/events/?mode=list](./?mode=list)
#### Filters
Parameters - `agency__ids`, `date__gt`, `date__gt__lt`, `date__gte`, `date__lte`, `day`, `id`, `last_updated__gte`, `last_updated__lte`, `month`, `program`, `slug`, `type`, `type__ids`, `video_url`, `year`
Example - [/events/?type__ids=2,8](./?type__ids=2,8)
#### Search
Fields searched - `name`
Example - [/events/?search=Flyby](./?search=Flyby)
#### Ordering
Fields - `date`, `last_updated`
Example - [/events/?ordering=-last_updated](./?ordering=-last_updated)
#### Number of results
Use `limit` to control the number of objects in the response (max 100)
Example - [/events/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/events/?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: agency__ids
schema:
type: array
items:
type: integer
description: Comma-separated agency IDs.
explode: false
style: form
- in: query
name: date__gt
schema:
type: string
format: date-time
description: Date is greater than
- in: query
name: date__gt__lt
schema:
type: string
format: date-time
description: Date is less than
- in: query
name: date__gte
schema:
type: string
format: date-time
description: Date is greater than or equal to
- in: query
name: date__lte
schema:
type: string
format: date-time
description: Date is less than or equal to
- in: query
name: day
schema:
type: array
items:
type: number
description: Multiple values may be separated by commas.
explode: false
style: form
- in: query
name: id
schema:
type: array
items:
type: integer
description: Multiple values may be separated by commas.
explode: false
style: form
- in: query
name: last_updated__gte
schema:
type: string
format: date-time
description: Last Update is greater than or equal to
- in: query
name: last_updated__lte
schema:
type: string
format: date-time
description: Last Update is less than or equal to
- 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: month
schema:
type: array
items:
type: number
description: Multiple values may be separated by commas.
explode: false
style: form
- 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: program
schema:
type: array
items:
type: integer
explode: true
style: form
- name: search
required: false
in: query
description: A search term.
schema:
type: string
- in: query
name: slug
schema:
type: string
- in: query
name: type
schema:
type: integer
maximum: 2147483647
minimum: -2147483648
- in: query
name: type__ids
schema:
type: array
items:
type: integer
description: Comma-separated event type IDs.
explode: false
style: form
- in: query
name: video_url
schema:
type: array
items:
type: string
description: Comma-separated video URLs.
explode: false
style: form
- in: query
name: year
schema:
type: array
items:
type: number
description: Multiple values may be separated by commas.
explode: false
style: form
tags:
- Events
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedPolymorphicEventsEndpointList'
description: ''
/2.3.0/events/{id}/:
get:
operationId: events_retrieve
summary: Get Event
description: '#### Modes
Levels of detail in the response - `list`, `normal`, `detailed`
Example - [/events/?mode=list](./?mode=list)
#### Filters
Parameters - `agency__ids`, `date__gt`, `date__gt__lt`, `date__gte`, `date__lte`, `day`, `id`, `last_updated__gte`, `last_updated__lte`, `month`, `program`, `slug`, `type`, `type__ids`, `video_url`, `year`
Example - [/events/?type__ids=2,8](./?type__ids=2,8)
#### Search
Fields searched - `name`
Example - [/events/?search=Flyby](./?search=Flyby)
#### Ordering
Fields - `date`, `last_updated`
Example - [/events/?ordering=-last_updated](./?ordering=-last_updated)
#### Number of results
Use `limit` to control the number of objects in the response (max 100)
Example - [/events/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/events/?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 Event.
required: true
tags:
- Events
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/EventEndpointDetailed'
description: ''
/2.3.0/events/previous/:
get:
operationId: events_previous_list
summary: List Previous Events
description: '#### Modes
Levels of detail in the response - `list`, `normal`, `detailed`
Example - [/events/previous/?mode=list](./?mode=list)
#### Filters
Parameters - `agency__ids`, `date__gt`, `date__gt__lt`, `date__gte`, `date__lte`, `day`, `id`, `last_updated__gte`, `last_updated__lte`, `month`, `program`, `slug`, `type`, `type__ids`, `video_url`, `year`
Example - [/events/previous/?type__ids=2,8](./?type__ids=2,8)
#### Search
Fields searched - `name`
Example - [/events/previous/?search=Flyby](./?search=Flyby)
#### Ordering
Fields - `date`, `last_updated`
Example - [/events/previous/?ordering=-last_updated](./?ordering=-last_updated)
#### Number of results
Use `limit` to control the number of objects in the response (max 100)
Example - [/events/previous/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/events/previous/?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: agency__ids
schema:
type: array
items:
type: integer
description: Comma-separated agency IDs.
explode: false
style: form
- in: query
name: date__gt
schema:
type: string
format: date-time
description: Date is greater than
- in: query
name: date__gt__lt
schema:
type: string
format: date-time
description: Date is less than
- in: query
name: date__gte
schema:
type: string
format: date-time
description: Date is greater than or equal to
- in: query
name: date__lte
schema:
type: string
format: date-time
description: Date is less than or equal to
- in: query
name: day
schema:
type: array
items:
type: number
description: Multiple values may be separated by commas.
explode: false
style: form
- in: query
name: id
schema:
type: array
items:
type: integer
description: Multiple values may be separated by commas.
explode: false
style: form
- in: query
name: last_updated__gte
schema:
type: string
format: date-time
description: Last Update is greater than or equal to
- in: query
name: last_updated__lte
schema:
type: string
format: date-time
description: Last Update is less than or equal to
- 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: month
schema:
type: array
items:
type: number
description: Multiple values may be separated by commas.
explode: false
style: form
- 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: program
schema:
type: array
items:
type: integer
explode: true
style: form
- name: search
required: false
in: query
description: A search term.
schema:
type: string
- in: query
name: slug
schema:
type: string
- in: query
name: type
schema:
type: integer
maximum: 2147483647
minimum: -2147483648
- in: query
name: type__ids
schema:
type: array
items:
type: integer
description: Comma-separated event type IDs.
explode: false
style: form
- in: query
name: video_url
schema:
type: array
items:
type: string
description: Comma-separated video URLs.
explode: false
style: form
- in: query
name: year
schema:
type: array
items:
type: number
description: Multiple values may be separated by commas.
explode: false
style: form
tags:
- Events
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedPolymorphicEventsEndpointList'
description: ''
/2.3.0/events/previous/{id}/:
get:
operationId: events_previous_retrieve
summary: Get Previous Event
description: '#### Modes
Levels of detail in the response - `list`, `normal`, `detailed`
Example - [/events/previous/?mode=list](./?mode=list)
#### Filters
Parameters - `agency__ids`, `date__gt`, `date__gt__lt`, `date__gte`, `date__lte`, `day`, `id`, `last_updated__gte`, `last_updated__lte`, `month`, `program`, `slug`, `type`, `type__ids`, `video_url`, `year`
Example - [/events/previous/?type__ids=2,8](./?type__ids=2,8)
#### Search
Fields searched - `name`
Example - [/events/previous/?search=Flyby](./?search=Flyby)
#### Ordering
Fields - `date`, `last_updated`
Example - [/events/previous/?ordering=-last_updated](./?ordering=-last_updated)
#### Number of results
Use `limit` to control the number of objects in the response (max 100)
Example - [/events/previous/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/events/previous/?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 Event.
required: true
tags:
- Events
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/EventEndpointDetailed'
description: ''
/2.3.0/events/upcoming/:
get:
operationId: events_upcoming_list
summary: List Upcoming Events
description: '#### Modes
Levels of detail in the response - `list`, `normal`, `detailed`
Example - [/events/upcoming/?mode=list](./?mode=list)
#### Filters
Parameters - `agency__ids`, `date__gt`, `date__gt__lt`, `date__gte`, `date__lte`, `day`, `hide_recent_previous`, `id`, `last_updated__gte`, `last_updated__lte`, `month`, `program`, `slug`, `type`, `type__ids`, `video_url`, `year`
Example - [/events/upcoming/?type__ids=2,8](./?type__ids=2,8)
#### Search
Fields searched - `name`
Example - [/events/upcoming/?search=Flyby](./?search=Flyby)
#### Ordering
Fields - `date`, `last_updated`
Example - [/events/upcoming/?ordering=-last_updated](./?ordering=-last_updated)
#### Number of results
Use `limit` to control the number of objects in the response (max 100)
Example - [/events/upcoming/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/events/upcoming/?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: agency__ids
schema:
type: array
items:
type: integer
description: Comma-separated agency IDs.
explode: false
style: form
- in: query
name: date__gt
schema:
type: string
format: date-time
description: Date is greater than
- in: query
name: date__gt__lt
schema:
type: string
format: date-time
description: Date is less than
- in: query
name: date__gte
schema:
type: string
format: date-time
description: Date is greater than or equal to
- in: query
name: date__lte
schema:
type: string
format: date-time
description: Date is less than or equal to
- in: query
name: day
schema:
type: array
items:
type: number
description: Multiple values may be separated by commas.
explode: false
style: form
- in: query
name: hide_recent_previous
schema:
type: boolean
description: Hide events from the past 24 hours, which are included by default for convenience.
- in: query
name: id
schema:
type: array
items:
type: integer
description: Multiple values may be separated by commas.
explode: false
style: form
- in: query
name: last_updated__gte
schema:
type: string
format: date-time
description: Last Update is greater than or equal to
- in: query
name: last_updated__lte
schema:
type: string
format: date-time
description: Last Update is less than or equal to
- 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: month
schema:
type: array
items:
type: number
description: Multiple values may be separated by commas.
explode: false
style: form
- 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: program
schema:
type: array
items:
type: integer
explode: true
style: form
- name: search
required: false
in: query
description: A search term.
schema:
type: string
- in: query
name: slug
schema:
type: string
- in: query
name: type
schema:
type: integer
maximum: 2147483647
minimum: -2147483648
- in: query
name: type__ids
schema:
type: array
items:
type: integer
description: Comma-separated event type IDs.
explode: false
style: form
- in: query
name: video_url
schema:
type: array
items:
type: string
description: Comma-separated video URLs.
explode: false
style: form
- in: query
name: year
schema:
type: array
items:
type: number
description: Multiple values may be separated by commas.
explode: false
style: form
tags:
- Events
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedPolymorphicEventsEndpointList'
description: ''
/2.3.0/events/upcoming/{id}/:
get:
operationId: events_upcoming_retrieve
summary: Get Upcoming Event
description: '#### Modes
Levels of detail in the response - `list`, `normal`, `detailed`
Example - [/events/upcoming/?mode=list](./?mode=list)
#### Filters
Parameters - `agency__ids`, `date__gt`, `date__gt__lt`, `date__gte`, `date__lte`, `day`, `hide_recent_previous`, `id`, `last_updated__gte`, `last_updated__lte`, `month`, `program`, `slug`, `type`, `type__ids`, `video_url`, `year`
Example - [/events/upcoming/?type__ids=2,8](./?type__ids=2,8)
#### Search
Fields searched - `name`
Example - [/events/upcoming/?search=Flyby](./?search=Flyby)
#### Ordering
Fields - `date`, `last_updated`
Example - [/events/upcoming/?ordering=-last_updated](./?ordering=-last_updated)
#### Number of results
Use `limit` to control the number of objects in the response (max 100)
Example - [/events/upcoming/?limit=2](./?limit=2)
#### Format
Switch to JSON output - [/events/upcoming/?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 Event.
required: true
tags:
- Events
security:
- cookieAuth: []
- Token_Authentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/EventEndpointDetailed'
description: ''
components:
schemas:
LandingLocation:
type: object
properties:
id:
type: integer
readOnly: true
name:
type: string
maxLength: 255
active:
type: boolean
abbrev:
type: string
maxLength: 255
description:
type: string
nullable: true
maxLength: 2048
location:
$ref: '#/components/schemas/LocationSerializerNoCelestialBody'
longitude:
type: number
format: double
nullable: true
latitude:
type: number
format: double
nullable: true
image:
allOf:
- $ref: '#/components/schemas/Image'
nullable: true
successful_landings:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
attempted_landings:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
failed_landings:
type: integer
maximum: 2147483647
minimum: -2147483648
nullable: true
celestial_body:
$ref: '#/components/schemas/CelestialBodyNormal'
required:
- celestial_body
- id
- image
- location
PayloadType:
type: object
properties:
id:
type: integer
maximum: 2147483647
minimum: -2147483648
name:
type: string
maxLength: 255
required:
- id
RocketNormal:
type: object
properties:
id:
type: integer
readOnly: true
configuration:
$ref: '#/components/schemas/LauncherConfigList'
required:
- configuration
- id
Mission:
type: object
properties:
id:
type: integer
readOnly: true
name:
type: string
maxLength: 255
type:
type: string
readOnly: true
description:
type: string
image:
allOf:
- $ref: '#/components/schemas/
# --- truncated at 32 KB (91 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/thespacedevs-ll2-api/refs/heads/main/openapi/thespacedevs-ll2-api-events-api-openapi.yml