# VALAR Documentation

> VALAR is a spacecraft mission planning and operations platform for tracking orbits, planning maneuvers, generating ephemerides, and managing collision risks.

- [Welcome to VALAR](https://docs.valar.space/getting-started/introduction.md): Get started with the VALAR platform for spacecraft mission planning and operations.
- [Account Setup](https://docs.valar.space/getting-started/account-setup.md): Learn how to set up your VALAR account and configure your organization
- [Quick Start Guide](https://docs.valar.space/getting-started/quick-start-guide.md): Get up and running with VALAR in minutes
- [Creating Your First Spacecraft](https://docs.valar.space/getting-started/first-spacecraft.md): Create and configure your first spacecraft on the New Spacecraft page
- [Application Overview](https://docs.valar.space/getting-started/understanding-dashboard.md): Navigate and utilize the VALAR application effectively
- [Core Concepts](https://docs.valar.space/platform-overview/core-concepts.md): Understand the fundamental concepts behind the VALAR platform
- [Platform Architecture](https://docs.valar.space/platform-overview/platform-architecture.md): Comprehensive guide to VALAR's user interface, navigation patterns, and platform organization
- [Measurement Types](https://docs.valar.space/platform-overview/measurement-types.md): Overview of tracking measurement types
- [Reference Frames](https://docs.valar.space/platform-overview/reference-frames.md): Understanding coordinate reference frames in VALAR
- [Force Model](https://docs.valar.space/platform-overview/force-model.md): How VALAR computes drag and solar radiation pressure forces, and what triggers attitude-dependent force modeling for your spacecraft
- [File Formats Overview](https://docs.valar.space/file-formats/overview.md): Overview of supported file formats for spacecraft data in VALAR
- [AOI GeoJSON Subset](https://docs.valar.space/file-formats/aoi-geojson.md): The RFC 7946 GeoJSON subset Areas of Interest accept on import, and the GeoJSON VALAR writes when you export a boundary
- [KML and KMZ Files](https://docs.valar.space/file-formats/kml.md): The KML and KMZ geometry VALAR accepts when you create an Area of Interest or replace an existing area's boundary, and the KML VALAR writes when you export one
- [OEM (Orbit Ephemeris Message)](https://docs.valar.space/file-formats/oem.md): Working with CCSDS Orbit Ephemeris Message format in VALAR
- [Orbit Parameter Message (OPM)](https://docs.valar.space/file-formats/opm.md): Working with CCSDS and SpaceX Orbit Parameter Message formats in VALAR
- [Orbit Mean-elements Message (OMM)](https://docs.valar.space/file-formats/omm.md): Working with CCSDS Orbit Mean-elements Message format in VALAR
- [TDM (Tracking Data Message)](https://docs.valar.space/file-formats/tdm.md): Working with CCSDS Tracking Data Message format in VALAR
- [OCM (Orbit Comprehensive Message)](https://docs.valar.space/file-formats/ocm.md): Working with CCSDS Orbit Comprehensive Message format in VALAR
- [CDM (Conjunction Data Message)](https://docs.valar.space/file-formats/cdm.md): Prepare and import complete CCSDS Conjunction Data Messages in VALAR
- [TLE (Two-Line Element)](https://docs.valar.space/file-formats/tle.md): Working with Two-Line Element format in VALAR
- [SP3 (Standard Product 3)](https://docs.valar.space/file-formats/sp3.md): Working with IGS SP3 orbit and clock format in VALAR
- [Spacecraft Schedule File (SSF)](https://docs.valar.space/file-formats/ssf.md): Read, validate, and exchange flat KVN-encoded spacecraft activity schedules covering ground passes, eclipses, apsides, node crossings, and SAA transits
- [AEM (Attitude Ephemeris Message)](https://docs.valar.space/file-formats/aem.md): Working with CCSDS Attitude Ephemeris Message format in VALAR
- [Spacecraft](https://docs.valar.space/features/spacecraft-management.md): Configure and manage your satellite fleet — identifiers, mass, drag and SRP, geometry, and components
- [Spacecraft Lookup](https://docs.valar.space/features/spacecraft-lookup.md): Find a spacecraft by NORAD, COSPAR, name, or external key, then reference it by id everywhere else in the API
- [Delete a spacecraft](https://docs.valar.space/features/spacecraft-deletion.md): Permanently delete an archived spacecraft — what it destroys, who can do it, and why it cannot be undone
- [State Vectors](https://docs.valar.space/features/state-vectors.md): View, import, and manage spacecraft state vectors and orbit solutions
- [Orbit age](https://docs.valar.space/features/orbit-age.md): Learn what a spacecraft's orbit age is and how its two graded levels — the degraded level (lower-accuracy public-TLE fallback) and the stale level (a stale-orbit warning) — govern every orbit-dependent product and surface in one orbit-data-age footer.
- [State Vector Comparison](https://docs.valar.space/features/state-vector-comparison.md): Compare two state vectors side-by-side, or check a single state vector's mean elements against a public TLE reference
- [Orbit Determination](https://docs.valar.space/features/orbit-determination.md): Run orbit estimation, manage orbit solutions, and interpret OD results
- [Ground Track Visualization](https://docs.valar.space/features/3d-ground-track.md): Explore spacecraft ground tracks and orbital trajectories in 2D and 3D
- [Ground-Track Evidence Inspector](https://docs.valar.space/features/ground-track-evidence.md): Inspect the fixed 15/1 ground-track reference, recorded evaluations, and canonical crossing/ground-track-error evidence for a modeled ground-track segment — read-only evidence, not campaign planning or command.
- [Keplerian Elements](https://docs.valar.space/features/orbit-elements-plots.md): Visualizing orbital elements over time
- [Importing Measurements](https://docs.valar.space/features/measurements-import.md): Upload measurements and ephemeris data
- [Viewing Measurements](https://docs.valar.space/features/measurements-data.md): Visualize, filter, and manage measurement data
- [Sensors](https://docs.valar.space/features/tracking-sensors.md): Managing ground station and tracking sensor configurations
- [Ephemeris Generation](https://docs.valar.space/features/ephemeris-generation.md): Generate OEM files from state vectors for mission planning and data sharing
- [TLE Generation](https://docs.valar.space/features/tle-generation.md): Generate Two-Line Element sets from state vectors
- [Burn Plan](https://docs.valar.space/features/burn-plan.md): Manage spacecraft maneuvers, import burn plans, and analyze performance
- [Planner](https://docs.valar.space/features/planner.md): Create and manage orbital maintenance plans using optimization algorithms
- [SMA Maintenance](https://docs.valar.space/features/planner/sma-maintenance.md): Maintain semi-major axis within a tolerance band using automated maneuver planning
- [Orbit Raise](https://docs.valar.space/features/planner/orbit-raise.md): Raise a spacecraft to a higher circular orbit and compare a min-fuel and a fastest option
- [Disposal in Mission Analysis](https://docs.valar.space/features/mission-analysis-disposal.md): Evaluate chemical and electric end-of-life disposal with explicit active and passive lifetime budgets.
- [Importing Maneuvers](https://docs.valar.space/features/maneuver-import.md): Steps to import maneuvers generated using third-party tools.
- [Exporting Maneuvers](https://docs.valar.space/features/maneuver-export.md): Export maneuvers in CCSDS compliant formats
- [Reporting Maneuver Execution](https://docs.valar.space/features/maneuver-telemetry.md): Capture real-time telemetry to improve estimation of maneuver performance
- [API Keys](https://docs.valar.space/features/api-keys.md): Create and manage API keys for programmatic access to the VALAR platform
- [Conjunction Classification](https://docs.valar.space/features/conjunction-classification.md): Monitor conjunction events and assess collision risk for your spacecraft
- [Conjunction Computation](https://docs.valar.space/features/conjunction-computation.md): Recompute conjunction assessments using your own state vectors
- [Fetch Alerts](https://docs.valar.space/features/fetch-alerts.md): Download alerts from external space surveillance providers
- [CAM Optimization](https://docs.valar.space/features/cam-optimization.md): Compute optimal collision avoidance maneuvers from conjunction events
- [Areas of Interest](https://docs.valar.space/features/areas-of-interest/overview.md): Inspect an Area of Interest, edit its identity and geometry in place, and review its 7-day overflight forecast
- [Create an AOI](https://docs.valar.space/features/areas-of-interest/create-aoi.md): Define an Area of Interest by drawing on the map, typing coordinates, or pasting GeoJSON
- [Overflight Events](https://docs.valar.space/features/areas-of-interest/overflight-events.md): Read predicted spacecraft overflight events for an Area of Interest on a 7-day heatmap, select any opportunity for its full per-event detail, and trigger recomputes
- [Off-nadir Opportunities](https://docs.valar.space/features/areas-of-interest/off-nadir-opportunities.md): Turn on off-nadir opportunities for an area of interest, and read the bounded / caveated / not assessable geometric assessment it adds to each one
- [AOI Map](https://docs.valar.space/features/areas-of-interest/map.md): See every Area of Interest in the workspace on a single world map, inspect any AOI in a hovercard, and start any creation flow from the same surface
- [AOI Timeline](https://docs.valar.space/features/areas-of-interest/timeline.md): See every Area of Interest's spacecraft overflight opportunities on one shared timeline, grouped by AOI
- [Task Automation](https://docs.valar.space/features/task-automation.md): Create, schedule, and trigger automated tasks for orbit determination and alert fetching
- [Ephemeris Push Task](https://docs.valar.space/features/ephemeris-push-task.md): Schedule automated ephemeris uploads to external space catalogs (Space-Track, EU-SST)
- [Attitude Modes Overview](https://docs.valar.space/features/attitude/overview.md): Understand attitude modes, body axes, target types, and the unified workspace catalog
- [Attitude Modes](https://docs.valar.space/features/attitude/modes.md): View, create, edit, and delete attitude modes in your workspace
- [Attitude Transitions](https://docs.valar.space/features/attitude/transitions.md): Schedule and manage attitude mode transitions for your spacecraft
- [Import & Export Attitude Ephemeris](https://docs.valar.space/features/attitude/ephemeris.md): Import and export spacecraft attitude ephemeris data using AEM files
- [Attitude Visualization](https://docs.valar.space/features/attitude/visualization.md): Read quaternion and Euler angle plots that show how your spacecraft was oriented over time
- [Passes Overview](https://docs.valar.space/features/passes/overview.md): Understand ground-station passes, coverage definitions, and how the Passes area's pages fit together
- [Elevation Masks](https://docs.valar.space/features/passes/elevation-masks.md): How a ground station's surveyed horizon and its minimum elevation combine into the horizon actually used for passes
- [Ground Stations](https://docs.valar.space/features/passes/stations.md): Manage ground stations and inspect their spacecraft pass geometry, coverage, and applied horizon
- [Timeline](https://docs.valar.space/features/passes/timeline.md): Read every requested station's pass outcome, including why a station shows nothing
- [Coverage Map](https://docs.valar.space/features/passes/coverage-map.md): See every ground station's coverage footprint at a shared reference altitude on a single geographic map
- [Mission Assessment](https://docs.valar.space/self-service/mission-assessment.md): Build an Earth-orbit mission concept and understand its delta-v, propellant and timeline.
- [List spacecraft](https://docs.valar.space/api-reference/spacecraft/list-spacecraft.md): Retrieves a paginated list of spacecraft for the current tenant.
- [Register a new spacecraft](https://docs.valar.space/api-reference/spacecraft/register-a-new-spacecraft.md): Creates a spacecraft.
- [Get spacecraft by UUID](https://docs.valar.space/api-reference/spacecraft/get-spacecraft-by-uuid.md): Retrieves a spacecraft by its canonical UUID id. A non-UUID value (NORAD, COSPAR, or name) is rejected with 400 VALIDATION_ERROR before resolution. Returns 404 if no such spacecraft exists.
- [Partially update a spacecraft](https://docs.valar.space/api-reference/spacecraft/partially-update-a-spacecraft.md): Updates only the provided fields of a spacecraft resolved strictly by id. Returns 404 if it does not exist.
- [Update a spacecraft lifecycle status](https://docs.valar.space/api-reference/spacecraft/update-a-spacecraft-lifecycle-status.md): Updates the lifecycle status (Active or Archived) of a spacecraft resolved strictly by id. Returns 404 if it does not exist.
- [List thrusters for a spacecraft](https://docs.valar.space/api-reference/thrusters/list-thrusters-for-a-spacecraft.md): Retrieves all thrusters for a parent spacecraft resolved strictly by id. Each type is rendered UPPER_CASE (DT-17). Returns 404 if the parent spacecraft does not exist.
- [Create a thruster](https://docs.valar.space/api-reference/thrusters/create-a-thruster.md): Creates a thruster under a parent spacecraft resolved strictly by id. Type is auto-computed from ISP and rendered UPPER_CASE (DT-17). Returns 404 if the parent spacecraft does not exist.
- [Get a thruster by id](https://docs.valar.space/api-reference/thrusters/get-a-thruster-by-id.md): Retrieves a thruster resolved strictly by id. Type is rendered UPPER_CASE (DT-17). Returns 404 if it does not exist.
- [Partially update a thruster](https://docs.valar.space/api-reference/thrusters/partially-update-a-thruster.md): Updates only the provided fields of a thruster resolved strictly by id. Type is re-computed from ISP and rendered UPPER_CASE (DT-17). Returns 404 if it does not exist.
- [Delete a thruster](https://docs.valar.space/api-reference/thrusters/delete-a-thruster.md): Deletes a thruster resolved strictly by id. Returns 404 if it does not exist.
- [List payloads for a spacecraft](https://docs.valar.space/api-reference/payloads/list-payloads-for-a-spacecraft.md): Retrieves all payloads for a parent spacecraft resolved strictly by id, ordered by payloadIndex ascending. Returns 404 if the parent spacecraft does not exist.
- [Add a payload](https://docs.valar.space/api-reference/payloads/add-a-payload.md): Adds a payload under a parent spacecraft resolved strictly by id. The server assigns the lowest-free slot index [0,7]; the 9th sensor is refused with 422 PAYLOAD_LIMIT_EXCEEDED. Returns 404 if the parent spacecraft does not exist.
- [Get a payload by id](https://docs.valar.space/api-reference/payloads/get-a-payload-by-id.md): Retrieves a payload reached only through the parent's collection. Returns a uniform 404 PAYLOAD_NOT_FOUND for an unknown id / foreign-tenant / wrong-parent (indistinguishable).
- [Partially update a payload](https://docs.valar.space/api-reference/payloads/partially-update-a-payload.md): Updates only the provided scalars of a payload in place (the UUID is never re-minted). The FOV group is an atomic replace: restate fovShape to change any FOV param; a lone FOV param without fovShape is a 400. Returns a uniform 404 for any miss vector. A genuine change to this payload's offNadirAlong…
- [Remove a payload](https://docs.valar.space/api-reference/payloads/remove-a-payload.md): Removes a payload reached only through the parent's collection; the freed slot index is left as a gap (never repacked). Returns a uniform 404 for any miss vector.
- [List state vectors for one or more spacecraft](https://docs.valar.space/api-reference/state-vectors/list-state-vectors-for-one-or-more-spacecraft.md): 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…
- [Import a state vector](https://docs.valar.space/api-reference/state-vectors/import-a-state-vector.md): Import a state vector from an external source (OPM or SpaceX OPM format). For OPM format, the spacecraft can be auto-resolved from OBJECT_ID and OBJECT_NAME in the CCSDS metadata when spacecraftId is omitted. SpaceX OPM format requires an explicit spacecraftId. Creates a StateVector only, not an Orb…
- [Get the latest state vector for a spacecraft](https://docs.valar.space/api-reference/state-vectors/get-the-latest-state-vector-for-a-spacecraft.md): Retrieves the most recent state vector for a spacecraft. By default, only converged state vectors are returned (imports are always valid, OD results only if converged). Set includeNonConverged=true to include all state vectors.
- [Get a state vector by ID](https://docs.valar.space/api-reference/state-vectors/get-a-state-vector-by-id.md): Retrieves a specific state vector by its unique identifier.
- [Delete a state vector](https://docs.valar.space/api-reference/state-vectors/delete-a-state-vector.md): Deletes a state vector by its unique identifier. Deletion is not allowed if the state vector is linked to an orbit solution (returns 409 Conflict).
- [Export a state vector as OMM](https://docs.valar.space/api-reference/state-vectors/export-a-state-vector-as-omm.md): Export a state vector in CCSDS OMM v2.0 format with mean Keplerian elements. Uses DSST (Draper Semi-analytical Satellite Theory) for osculating-to-mean element conversion.
- [Export a state vector as OPM](https://docs.valar.space/api-reference/state-vectors/export-a-state-vector-as-opm.md): Export a state vector in CCSDS OPM v2.0 format. Optionally includes covariance data if available.
- [Generate OEM from a state vector](https://docs.valar.space/api-reference/state-vectors/generate-oem-from-a-state-vector.md): Generate CCSDS OEM v2.0 format ephemerides from a state vector with specified time range, reference frame, time system, and optional covariance propagation. Maximum time span is 30 days.
- [Query measurements with pagination and filtering](https://docs.valar.space/api-reference/measurements/query-measurements-with-pagination-and-filtering.md): Retrieves paginated measurements with optional filtering by spacecraft, measurement type, date range, and outlier status. Results are sorted by epoch descending by default.
- [Upload measurement files](https://docs.valar.space/api-reference/measurements/upload-measurement-files.md): Upload one or more measurement files for asynchronous processing. Supported formats: TDM (Tracking Data Message), SP3 (Standard Product 3), and OEM (Orbit Ephemeris Message). Each file is validated synchronously and then queued as a background job for full processing. The response includes per-file…
- [Bulk mark or unmark measurements as outliers by ID list](https://docs.valar.space/api-reference/measurements/bulk-mark-or-unmark-measurements-as-outliers-by-id-list.md): Performs a bulk update of the outlier status on multiple measurements simultaneously. Maximum 1000 measurement IDs per request. Non-existent IDs are silently ignored. The returned count reflects only actually updated measurements.
- [Bulk mark or unmark measurements as outliers by source file](https://docs.valar.space/api-reference/measurements/bulk-mark-or-unmark-measurements-as-outliers-by-source-file.md): Performs a bulk update of the outlier status on all measurements originating from a specific source file. File name matching is exact and case-sensitive. The returned count reflects all matching measurements updated within the current tenant.
- [Delete measurements by source file](https://docs.valar.space/api-reference/measurements/delete-measurements-by-source-file.md): Permanently deletes all measurements for a spacecraft from a specific source file. This is useful when an uploaded file contains incorrect data. WARNING: This operation cannot be undone. Returns 200 with deletedCount=0 if no matching measurements are found.

## OpenAPI Specs

- [mintlify](https://api.valar.space/api-docs/mintlify)

## Optional

- [Website](https://www.valar.space)
- [Application](https://app.valar.space)
- [API Status](https://stats.uptimerobot.com/6NpPOCPkWz)