> ## Documentation Index
> Fetch the complete documentation index at: https://docs.valar.space/llms.txt
> Use this file to discover all available pages before exploring further.
# List state vectors for one or more spacecraft
> Retrieves a paginated list of state vectors for the specified spacecraft(s), with optional date range filtering. The spacecraftId parameter may be repeated to query multiple spacecraft in a single call (e.g. ?spacecraftId=A&spacecraftId=B); results are merged into a single paginated set. Results are sorted by epoch descending by default. Empty results return 200 with an empty page.
## OpenAPI
````yaml https://api.valar.space/api-docs/mintlify get /operations/state-vectors
openapi: 3.0.1
info:
contact:
email: api@valar.space
name: Valar Space
url: https://valar.space
description: >-
Welcome to the documentation for the Valar Operations API, here are some
quick tips if you just landed!
- The top level elements are the
Resources accessible via the API and the different queries used to
interact with each resource via the appropriate HTTP method call.
-
You can expand each method to get further information on the expected input
parameters and the different responses that can be received.
- For
both the input parameters and responses, an Example is present for
clarification.
- For further details, the example snipped can be
switched to Schema view, where a detailed explanation of each element
can be found.
- The Try it out button can be used to call the
API directly from the documentation page, which allows for some easy testing
and also provides the equivalent 'curl' command line code for easy
portability of the call execution.
- Before starting, select
Authorize and enter your API key. The key is sent as a bearer token
in the
Authorization header.
title: API Documentation
version: 1.0.0
servers:
- url: https://api.valar.space
description: VALAR API Server
- url: https://api.valar.space
description: API Server
security:
- apiKeyAuth: []
tags:
- description: >-
Operations for managing state vectors — listing, importing, exporting, and
deleting spacecraft state data
name: State Vectors
- description: Register, list, read, update, and manage the lifecycle of your spacecraft.
name: Spacecraft
- description: Manage the thrusters mounted on a spacecraft.
name: Thrusters
- description: Manage the payloads (sensors) mounted on a spacecraft.
name: Payloads
- description: >-
Maneuver API 3.0.0: import and export spacecraft maneuvers using CCSDS
OCM, and delete stored maneuvers.
name: Maneuvers
paths:
/operations/state-vectors:
get:
tags:
- State Vectors
summary: List state vectors for one or more spacecraft
description: >-
Retrieves a paginated list of state vectors for the specified
spacecraft(s), with optional date range filtering. The spacecraftId
parameter may be repeated to query multiple spacecraft in a single call
(e.g. ?spacecraftId=A&spacecraftId=B); results are merged into a single
paginated set. Results are sorted by epoch descending by default. Empty
results return 200 with an empty page.
operationId: getStateVectors
parameters:
- description: >-
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.
example: 550e8400-e29b-41d4-a716-446655440000
in: query
name: spacecraftId
required: true
schema:
maxItems: 50
minItems: 1
type: array
items:
type: string
- description: Start of date range filter (inclusive, ISO-8601)
example: '2025-01-01T00:00:00Z'
in: query
name: startDate
required: false
schema:
type: string
format: date-time
- description: End of date range filter (inclusive, ISO-8601)
example: '2025-01-02T00:00:00Z'
in: query
name: endDate
required: false
schema:
type: string
format: date-time
- in: query
name: pageable
required: true
schema:
$ref: '#/components/schemas/Pageable'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ReferenceResolvingPaginatedResponse'
description: Successfully retrieved state vectors
'400':
content:
application/json:
example:
timestamp: '2025-01-15T10:30:00.000Z'
status: 400
error: Bad Request
message: Required parameter 'spacecraftId' is not present
path: /operations/state-vectors
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Invalid request parameters
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/BearerTokenErrorResponse'
description: Not authenticated — missing or invalid bearer token
'403':
content:
application/json:
example:
timestamp: '2025-01-15T10:30:00.000Z'
status: 403
error: ACCESS_ERROR
message: Access denied
path: /operations/state-vectors
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Insufficient permissions
'500':
content:
application/json:
example:
timestamp: '2025-01-15T10:30:00.000Z'
status: 500
error: Internal Server Error
message: An unexpected error occurred
path: /operations/state-vectors
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Internal server error
security:
- apiKeyAuth: []
components:
schemas:
Pageable:
type: object
properties:
page:
minimum: 0
type: integer
format: int32
size:
minimum: 1
type: integer
format: int32
sort:
type: array
items:
type: string
ReferenceResolvingPaginatedResponse:
required:
- unresolvedSpacecraftReferences
type: object
properties:
content:
type: array
description: List of items in the current page
items:
type: object
description: List of items in the current page
first:
type: boolean
description: Whether this is the first page
example: true
hasNext:
type: boolean
description: Whether there are more pages after this one
example: true
hasPrevious:
type: boolean
description: Whether there are pages before this one
example: false
last:
type: boolean
description: Whether this is the last page
example: false
page:
type: integer
description: Current page number (0-indexed)
format: int32
example: 0
size:
type: integer
description: Number of items per page
format: int32
example: 20
totalElements:
type: integer
description: Total number of elements across all pages
format: int64
example: 150
totalPages:
type: integer
description: Total number of pages
format: int32
example: 8
unresolvedSpacecraftReferences:
type: array
description: >-
Spacecraft references the caller supplied that did not resolve
(de-duplicated, caller order preserved). Always present; an empty
array means every supplied reference resolved.
items:
type: string
description: >-
Spacecraft references the caller supplied that did not resolve
(de-duplicated, caller order preserved). Always present; an empty
array means every supplied reference resolved.
description: >-
Paginated response wrapper that also reports which supplied spacecraft
references did not resolve (drop-report)
ErrorResponse:
type: object
properties:
code:
type: string
description: Stable frontend-dictionary error code
nullable: true
example: import.tracking.tdm.parse_failed
correlationId:
type: string
description: Server-generated opaque identifier for support correlation
nullable: true
example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
details:
type: object
additionalProperties:
type: object
description: Structured error details with scenario-specific context fields
nullable: true
description: Structured error details with scenario-specific context fields
nullable: true
error:
type: string
description: The HTTP status reason phrase or exception-handler code
example: Bad Request
fieldErrors:
type: object
additionalProperties:
type: string
description: Field-level validation errors (field name to error message)
description: Field-level validation errors (field name to error message)
message:
type: string
description: Detailed error message
example: Invalid spacecraft ID format
params:
type: object
additionalProperties:
type: string
description: Per-key allowlisted structured params for frontend rendering
nullable: true
description: Per-key allowlisted structured params for frontend rendering
nullable: true
path:
type: string
description: The request path where the error occurred
example: /api/v1/stm/credentials
status:
type: integer
description: The HTTP status code
format: int32
example: 400
timestamp:
type: string
description: The timestamp when the error occurred
format: date-time
example: '2025-11-14T10:15:30.123Z'
description: Standard API error response
BearerTokenErrorResponse:
type: object
properties:
error:
type: string
description: OAuth 2.0 error code
example: invalid_token
error_description:
type: string
description: Human-readable error description
example: An error occurred while attempting to decode the Jwt
description: OAuth 2.0 Bearer Token error response (RFC 6750)
securitySchemes:
apiKeyAuth:
description: 'API Key (format: vsp_sk_...)'
scheme: bearer
type: http
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.