Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

API Key (format: vsp_sk_...)

Query Parameters

spacecraftId
string[]
required

Spacecraft identifier(s) to filter state vectors by. Required; may be repeated to query multiple spacecraft in a single call (e.g. ?spacecraftId=A&spacecraftId=B), in which case results are merged into a single paginated set sorted by epoch desc.

Required array length: 1 - 50 elements
startDate
string<date-time>

Start of date range filter (inclusive, ISO-8601)

endDate
string<date-time>

End of date range filter (inclusive, ISO-8601)

pageable
object
required

Response

Successfully retrieved state vectors

Paginated response wrapper that also reports which supplied spacecraft references did not resolve (drop-report)

unresolvedSpacecraftReferences
string[]
required

Spacecraft references the caller supplied that did not resolve (de-duplicated, caller order preserved). Always present; an empty array means every supplied reference resolved.

Spacecraft references the caller supplied that did not resolve (de-duplicated, caller order preserved). Always present; an empty array means every supplied reference resolved.

content
object[]

List of items in the current page

first
boolean

Whether this is the first page

Example:

true

hasNext
boolean

Whether there are more pages after this one

Example:

true

hasPrevious
boolean

Whether there are pages before this one

Example:

false

last
boolean

Whether this is the last page

Example:

false

page
integer<int32>

Current page number (0-indexed)

Example:

0

size
integer<int32>

Number of items per page

Example:

20

totalElements
integer<int64>

Total number of elements across all pages

Example:

150

totalPages
integer<int32>

Total number of pages

Example:

8