Skip to content

File Operations

Space-Track provides several file-based endpoints beyond the standard query API. These operations are direct client methods -- they do not use the SpaceTrackQuery builder. The three subsystems are FileShare (authenticated file storage), SP Ephemeris (special perturbations ephemeris files), and Public Files (unauthenticated downloads).

For the complete API reference, see the SpaceTrackClient Reference.

FileShare

The FileShare subsystem provides authenticated file storage on Space-Track.org. Users can upload, download, list, and delete files organized into folders.

Listing Files and Folders

Retrieve metadata for all files or folders in your file share. Results are returned as typed records (FileShareFileRecord and FolderRecord).

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
import brahe as bh

client = bh.SpaceTrackClient("user@example.com", "password")

# List all files
files = client.fileshare_list_files()
for f in files:
    print(f"ID: {f.file_id}, Name: {f.file_name}, Size: {f.file_size}")

# List all folders
folders = client.fileshare_list_folders()
for folder in folders:
    print(f"ID: {folder.folder_id}, Name: {folder.folder_name}")

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
use brahe::spacetrack::SpaceTrackClient;

let client = SpaceTrackClient::new("user@example.com", "password");

// List all files
let files = client.fileshare_list_files().unwrap();
for f in &files {
    println!("ID: {:?}, Name: {:?}, Size: {:?}",
        f.file_id, f.file_name, f.file_size);
}

// List all folders
let folders = client.fileshare_list_folders().unwrap();
for folder in &folders {
    println!("ID: {:?}, Name: {:?}",
        folder.folder_id, folder.folder_name);
}

Uploading Files

Upload a file to a specific folder. The file_data parameter accepts raw bytes.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
import brahe as bh

client = bh.SpaceTrackClient("user@example.com", "password")

# Upload from bytes
response = client.fileshare_upload("100", "ephemeris.txt", b"file contents here")

# Upload from a file on disk
with open("local_data.csv", "rb") as f:
    response = client.fileshare_upload("100", "local_data.csv", f.read())

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
use brahe::spacetrack::SpaceTrackClient;

let client = SpaceTrackClient::new("user@example.com", "password");

// Upload from bytes
let response = client.fileshare_upload(
    "100", "ephemeris.txt", b"file contents here"
).unwrap();

// Upload from a file on disk
let data = std::fs::read("local_data.csv").unwrap();
let response = client.fileshare_upload(
    "100", "local_data.csv", &data
).unwrap();

Downloading Files

Download a single file by its ID, or download an entire folder as a zip archive.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
import brahe as bh

client = bh.SpaceTrackClient("user@example.com", "password")

# Download a single file (returns bytes)
data = client.fileshare_download("12345")
with open("downloaded.txt", "wb") as f:
    f.write(data)

# Download an entire folder (returns zip archive bytes)
zip_data = client.fileshare_download_folder("100")
with open("folder_archive.zip", "wb") as f:
    f.write(zip_data)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
use brahe::spacetrack::SpaceTrackClient;

let client = SpaceTrackClient::new("user@example.com", "password");

// Download a single file (returns Vec<u8>)
let data = client.fileshare_download("12345").unwrap();
std::fs::write("downloaded.txt", &data).unwrap();

// Download an entire folder (returns zip archive bytes)
let zip_data = client.fileshare_download_folder("100").unwrap();
std::fs::write("folder_archive.zip", &zip_data).unwrap();

Deleting Files

Delete a file by its ID.

1
2
3
4
import brahe as bh

client = bh.SpaceTrackClient("user@example.com", "password")
response = client.fileshare_delete("12345")

1
2
3
4
use brahe::spacetrack::SpaceTrackClient;

let client = SpaceTrackClient::new("user@example.com", "password");
let response = client.fileshare_delete("12345").unwrap();

SP Ephemeris

The SP Ephemeris subsystem provides access to Special Perturbations ephemeris files. These are higher-fidelity orbital predictions than the standard GP (General Perturbations) data. All SP Ephemeris operations require authentication.

Listing Ephemeris Files

List available SP ephemeris files. Each record includes the associated NORAD catalog ID and the epoch coverage interval.

1
2
3
4
5
6
7
8
import brahe as bh

client = bh.SpaceTrackClient("user@example.com", "password")

files = client.spephemeris_list_files()
for f in files:
    print(f"ID: {f.file_id}, Object: {f.norad_cat_id}, "
          f"Epoch: {f.epoch_start} to {f.epoch_stop}")

1
2
3
4
5
6
7
8
9
use brahe::spacetrack::SpaceTrackClient;

let client = SpaceTrackClient::new("user@example.com", "password");

let files = client.spephemeris_list_files().unwrap();
for f in &files {
    println!("ID: {:?}, Object: {:?}, Epoch: {:?} to {:?}",
        f.file_id, f.norad_cat_id, f.epoch_start, f.epoch_stop);
}

Downloading Ephemeris Files

Download an SP ephemeris file by its file ID.

1
2
3
4
5
6
7
import brahe as bh

client = bh.SpaceTrackClient("user@example.com", "password")

data = client.spephemeris_download("99999")
with open("iss_sp.e", "wb") as f:
    f.write(data)

1
2
3
4
5
6
use brahe::spacetrack::SpaceTrackClient;

let client = SpaceTrackClient::new("user@example.com", "password");

let data = client.spephemeris_download("99999").unwrap();
std::fs::write("iss_sp.e", &data).unwrap();

File History

Retrieve the version history for SP ephemeris files. The response is returned as generic JSON since the schema is not fixed.

1
2
3
4
5
6
7
import brahe as bh

client = bh.SpaceTrackClient("user@example.com", "password")

history = client.spephemeris_file_history()
for record in history:
    print(record)

1
2
3
4
5
6
7
8
use brahe::spacetrack::SpaceTrackClient;

let client = SpaceTrackClient::new("user@example.com", "password");

let history = client.spephemeris_file_history().unwrap();
for record in &history {
    println!("{}", record);
}

Public Files

The Public Files subsystem provides access to publicly available files on Space-Track.org. These operations do not require authentication, though the client must still be instantiated (credentials are not sent for these requests).

Listing Directories

List available public file directories. The response is returned as generic JSON.

1
2
3
4
5
6
7
import brahe as bh

client = bh.SpaceTrackClient("user@example.com", "password")

dirs = client.publicfiles_list_dirs()
for d in dirs:
    print(d)

1
2
3
4
5
6
7
8
use brahe::spacetrack::SpaceTrackClient;

let client = SpaceTrackClient::new("user@example.com", "password");

let dirs = client.publicfiles_list_dirs().unwrap();
for d in &dirs {
    println!("{}", d);
}

Downloading Public Files

Download a public file by name.

1
2
3
4
5
6
7
import brahe as bh

client = bh.SpaceTrackClient("user@example.com", "password")

data = client.publicfiles_download("catalog.txt")
with open("catalog.txt", "wb") as f:
    f.write(data)

1
2
3
4
5
6
use brahe::spacetrack::SpaceTrackClient;

let client = SpaceTrackClient::new("user@example.com", "password");

let data = client.publicfiles_download("catalog.txt").unwrap();
std::fs::write("catalog.txt", &data).unwrap();

See Also