# SatNOGS

> Track satellites and the radio passes recorded by SatNOGS, the Libre Space Foundation's open network of volunteer ground stations. Search SatNOGS DB for satellites and their transmitters by name, mode or frequency, and get a satellite's latest orbital elements (TLE); list and read observations with their rating and links to the waterfall, audio and decoded data, the passes scheduled next, and the ground stations near a place. A trigger starts a workflow when a satellite's pass is recorded. No account or API key required.

App · 12 actions. Web page: https://docs.lodol.com/docs/integrations/satnogs

## Actions

### Get a ground station

Read one SatNOGS ground station, online or not: its owner, position and grid locator, antennas and the frequencies they cover, status, when it last checked in, how many passes it has recorded and scheduled, and its success rate.

**Inputs**

- Ground station (`ground_station`, text, required): Pick a ground station that is online or testing, or type any station's ID or its SatNOGS Network address.

**Outputs**

- `altitude_m` (number): Its height above sea level in metres
- `antennas` (list): Its antennas
- `bands` (list): Every band its antennas cover, such as VHF and UHF
- `client_version` (text): The SatNOGS client version it runs
- `created_at` (text): When it joined the network, in ISO 8601 UTC
- `description` (text): Its owner's description of its equipment
- `future_observation_count` (number): How many observations it has scheduled
- `id` (number): The ground station's ID
- `image_url` (text): A picture of the station; empty when none
- `last_seen_at` (text): When it last checked in, in ISO 8601 UTC
- `latitude` (number): Its latitude in degrees
- `longitude` (number): Its longitude in degrees
- `min_horizon_deg` (number): The lowest elevation it listens down to, in degrees
- `name` (text): The station's name
- `observation_count` (number): How many observations it has made
- `owner` (text): The SatNOGS user who runs it
- `qth_locator` (text): Its Maidenhead grid locator, such as JN97ww
- `status` (text): Online, Testing or Offline
- `success_rate_percent` (number): The share of its observations rated good, 0 to 100
- `url` (text): The station's page on SatNOGS Network

**Example output**

```json
{
  "altitude_m": 100.0,
  "antennas": [
    {
      "band": "UHF",
      "max_mhz": 440.0,
      "min_mhz": 429.999999,
      "type": "Turnstile"
    }
  ],
  "bands": [
    "UHF"
  ],
  "client_version": "2.1.4",
  "created_at": "2026-09-29T10:21:24Z",
  "description": "",
  "future_observation_count": 21,
  "id": 5232,
  "image_url": "https://network-satnogs.freetls.fastly.net/media/ground_stations/8dba25c4-6e5c-497a-aa69-02823d76c9da.jpg",
  "last_seen_at": "2026-10-23T16:46:20Z",
  "latitude": 37.99922,
  "longitude": 23.706332,
  "min_horizon_deg": 10.0,
  "name": "yiami",
  "observation_count": 466,
  "owner": "yiami",
  "qth_locator": "KM17ux",
  "status": "Online",
  "success_rate_percent": 79.0,
  "url": "https://network.satnogs.org/stations/5232/"
}
```

### Get a satellite

Read one satellite from SatNOGS DB: its names, NORAD ID, status, launch, deployment and re-entry dates, operator, countries, website, picture, and whether SatNOGS can decode its telemetry.

**Inputs**

- Satellite (`satellite`, text, required): Pick a satellite, or type its NORAD ID (25544 for the ISS), its SatNOGS ID or its SatNOGS DB address.

**Outputs**

- `alternative_names` (list): Other names it goes by, such as call signs
- `associated_satellites` (list): SatNOGS IDs of entries for the same spacecraft, such as before it got its NORAD number
- `countries` (list): The countries it belongs to, as two-letter codes
- `decayed_at` (text): When it re-entered the atmosphere, in ISO 8601 UTC; empty while in orbit
- `deployed_at` (text): When it was deployed, in ISO 8601 UTC; empty when unknown
- `has_telemetry_decoder` (true/false): True when SatNOGS can decode the telemetry this satellite sends
- `image_url` (text): A picture of the satellite; empty when SatNOGS has none
- `is_frequency_violator` (true/false): True when the satellite transmits on frequencies it was not coordinated for
- `launched_at` (text): When it was launched, in ISO 8601 UTC; empty when unknown
- `name` (text): The satellite's name
- `norad_cat_id` (number): The satellite's NORAD catalog number, such as 25544 for the ISS; empty for a satellite not yet catalogued
- `operator` (text): Who operates it; empty when SatNOGS does not know
- `sat_id` (text): SatNOGS's own ID for the satellite, such as XSKZ-5603-1870-9019-3066
- `status` (text): in orbit, future, re-entered or launch failed
- `updated_at` (text): When SatNOGS DB last changed this entry, in ISO 8601 UTC
- `url` (text): The satellite's page in SatNOGS DB
- `website` (text): The mission's own website; empty when none

**Example output**

```json
{
  "alternative_names": [
    "ZARYA",
    "RS0ISS",
    "NA1SS"
  ],
  "associated_satellites": [],
  "countries": [
    "RU",
    "US"
  ],
  "decayed_at": "",
  "deployed_at": "",
  "has_telemetry_decoder": true,
  "image_url": "https://db-satnogs.freetls.fastly.net/media/satellites/ISS.jpg",
  "is_frequency_violator": false,
  "launched_at": "1998-11-20T00:00:00Z",
  "name": "ISS",
  "norad_cat_id": 25544,
  "operator": "",
  "sat_id": "XSKZ-5603-1870-9019-3066",
  "status": "in orbit",
  "updated_at": "2025-08-01T05:17:04Z",
  "url": "https://db.satnogs.org/satellite/XSKZ-5603-1870-9019-3066",
  "website": "https://www.nasa.gov/mission_pages/station/main/index.html"
}
```

### Get a satellite's latest TLE

Get the newest two-line element set (TLE) SatNOGS DB holds for a satellite, the orbital elements tracking software uses to predict passes, with its epoch, source, inclination, period, and the orbit's highest and lowest points in km worked out.

**Inputs**

- Satellite (`satellite`, text, required): Pick a satellite, or type its NORAD ID (25544 for the ISS), its SatNOGS ID or its SatNOGS DB address.

**Outputs**

- `apogee_km` (number): Highest point above the Earth's surface in km
- `eccentricity` (number): Orbit eccentricity, from 0 (a circle) up
- `epoch` (text): The moment the elements describe, in ISO 8601 UTC
- `inclination_deg` (number): Orbit inclination in degrees
- `mean_motion_revs_per_day` (number): Orbits completed per day
- `norad_cat_id` (number): The satellite's NORAD catalog number
- `perigee_km` (number): Lowest point above the Earth's surface in km
- `period_minutes` (number): Minutes per orbit
- `revolution_number` (number): Orbits completed since launch, at the epoch
- `sat_id` (text): The satellite's SatNOGS ID
- `source` (text): Where SatNOGS took the TLE from, such as Space-Track.org
- `tle0` (text): Line 0: the satellite's name as the TLE's source gives it
- `tle1` (text): Line 1 of the two-line element set
- `tle2` (text): Line 2 of the two-line element set
- `updated_at` (text): When SatNOGS DB stored it, in ISO 8601 UTC

**Example output**

```json
{
  "apogee_km": 424.3,
  "eccentricity": 0.0006864,
  "epoch": "2026-10-22T23:36:04Z",
  "inclination_deg": 51.6334,
  "mean_motion_revs_per_day": 15.49006294,
  "norad_cat_id": 25544,
  "perigee_km": 415.0,
  "period_minutes": 92.96,
  "revolution_number": 59156,
  "sat_id": "XSKZ-5603-1870-9019-3066",
  "source": "CalPoly",
  "tle0": "ISS",
  "tle1": "1 25544U 98067A   26295.98338418  .00009682  00000-0  18356-3 0  9999",
  "tle2": "2 25544  51.6334  27.6879 0006864 297.6388  62.3903 15.49006294591569",
  "updated_at": "2026-10-23T11:25:33Z"
}
```

### Get a transmitter

Read one transmitter from SatNOGS DB by its ID, with its satellite, frequencies, mode and status, and how SatNOGS Network's passes of it went: how many were made, rated good or bad, and the success rate.

**Inputs**

- Transmitter ID (`transmitter`, text, required): The transmitter's SatNOGS ID: 22 letters and digits, such as one from 'List a satellite's transmitters' or an observation's transmitter_uuid.

**Outputs**

- `alive` (true/false): True while SatNOGS believes it still transmits
- `bad_count` (number): Observations rated bad: nothing was received
- `baud` (number): Symbol rate in baud for a data signal; empty for voice or beacons
- `citation` (text): Where SatNOGS took the details from
- `description` (text): What it is, such as Mode V APRS
- `downlink_high_mhz` (number): The high end of the downlink band in MHz; empty for a single frequency
- `downlink_low_mhz` (number): Downlink frequency in MHz (the low end of a band)
- `frequency_violation` (true/false): True when it transmits outside the frequency it was coordinated for
- `future_count` (number): Observations scheduled but not yet made
- `good_count` (number): Observations rated good: the signal was received
- `iaru_coordination` (text): Whether the frequency was coordinated with the IARU: IARU Coordinated, IARU Uncoordinated, IARU Declined or N/A
- `invert` (true/false): True when a transponder inverts the signal it relays
- `mode` (text): How the downlink is modulated, such as FM, AFSK or BPSK
- `norad_cat_id` (number): The NORAD catalog number of its satellite
- `observation_count` (number): How many SatNOGS Network observations have listened to it
- `sat_id` (text): SatNOGS's ID for its satellite
- `satellite_name` (text): The name of its satellite
- `service` (text): The radio service it is licensed for, such as Amateur or Meteorological
- `status` (text): active, inactive or invalid
- `success_rate_percent` (number): The share of its observations rated good, from 0 to 100
- `type` (text): Transmitter, Transceiver (also receives) or Transponder (relays)
- `unconfirmed` (true/false): True while the transmitter's details are not yet confirmed
- `unknown_count` (number): Observations nobody has rated yet
- `updated_at` (text): When SatNOGS DB last changed it, in ISO 8601 UTC
- `uplink_high_mhz` (number): The high end of the uplink band in MHz; empty when none
- `uplink_low_mhz` (number): Uplink frequency in MHz; empty when it has no uplink
- `uplink_mode` (text): How the uplink is modulated; empty when it has none
- `uuid` (text): SatNOGS's ID for the transmitter, such as ZJxCeQmih9zDfYNVrB4wRN

**Example output**

```json
{
  "alive": true,
  "bad_count": 415,
  "baud": null,
  "citation": "https://community.libre.space/t/iss-sstv-event-from-2026-05-08-to-2026-05-12/14736",
  "description": "Mode U - SSTV - Robot-36",
  "downlink_high_mhz": 437.55,
  "downlink_low_mhz": 437.55,
  "frequency_violation": false,
  "future_count": 105,
  "good_count": 2357,
  "iaru_coordination": "N/A",
  "invert": false,
  "mode": "SSTV",
  "norad_cat_id": 25544,
  "observation_count": 3921,
  "sat_id": "XSKZ-5603-1870-9019-3066",
  "satellite_name": "ISS",
  "service": "Amateur",
  "status": "active",
  "success_rate_percent": 60.0,
  "type": "Transmitter",
  "unconfirmed": false,
  "unknown_count": 1044,
  "updated_at": "2026-05-07T23:47:31Z",
  "uplink_high_mhz": null,
  "uplink_low_mhz": null,
  "uplink_mode": "",
  "uuid": "bSPmbvvAavnj9XHMim8yEc"
}
```

### Get an observation

Read one recorded pass from SatNOGS Network: the satellite, transmitter and frequency, the ground station and its position, when it began and ended, how high the satellite rose, its rating, and links to the waterfall picture, the audio recording and every file of decoded data.

**Inputs**

- Observation (`observation`, text, required): The observation's ID, such as 15271547, or its SatNOGS Network address.

**Outputs**

- `archive_url` (text): The recording on the Internet Archive; empty until archived
- `archived` (true/false): True once the recording has moved to the Internet Archive
- `audio_url` (text): The recorded audio (OGG); empty until uploaded
- `baud` (number): The data rate listened for, in baud; empty for voice or images
- `data_count` (number): How many decoded data files there are
- `data_urls` (list): Files of data decoded from the pass, such as frames or images
- `duration_minutes` (number): How long the pass lasted, in minutes
- `end` (text): When the pass ended, in ISO 8601 UTC
- `frequency_mhz` (number): The frequency the station tuned to, in MHz
- `ground_station_id` (number): The ID of the ground station that listened
- `id` (number): The observation's ID
- `max_altitude_deg` (number): How high the satellite rose above the horizon, in degrees
- `norad_cat_id` (number): The NORAD catalog number of the satellite observed
- `observer` (text): The SatNOGS user who scheduled the observation
- `rise_azimuth_deg` (number): Compass direction where it rose, in degrees
- `sat_id` (text): The SatNOGS ID of the satellite observed
- `set_azimuth_deg` (number): Compass direction where it set, in degrees
- `start` (text): When the pass began, in ISO 8601 UTC
- `station_altitude_m` (number): The station's height above sea level in metres
- `station_latitude` (number): The station's latitude in degrees
- `station_longitude` (number): The station's longitude in degrees
- `station_name` (text): The ground station's name
- `station_url` (text): The ground station's page on SatNOGS Network
- `status` (text): good (the signal was received), bad (nothing was), failed (the station could not record), unknown (not yet rated) or future (not yet made)
- `transmitter_description` (text): The transmitter listened to, such as Mode V APRS
- `transmitter_downlink_mhz` (number): The transmitter's downlink frequency in MHz
- `transmitter_mode` (text): Its mode, such as FM, SSTV or BPSK
- `transmitter_type` (text): Transmitter, Transceiver or Transponder
- `transmitter_uuid` (text): The SatNOGS DB ID of the transmitter listened to
- `url` (text): The observation's page on SatNOGS Network
- `vetted_at` (text): When the pass was rated, in ISO 8601 UTC; empty if not yet
- `waterfall_status` (text): with-signal, without-signal or unknown
- `waterfall_url` (text): The waterfall picture of the pass; empty until uploaded

**Example output**

```json
{
  "archive_url": "",
  "archived": false,
  "audio_url": "https://network-satnogs.freetls.fastly.net/media/data_obs/2026/10/23/16/15271547/satnogs_15271547_2026-10-23T16-35-07.ogg",
  "baud": null,
  "data_count": 1,
  "data_urls": [
    "https://s3.eu-central-1.wasabisys.com/satnogs-network/data_obs/2026/10/23/16/15271547/data_15271547_2026-10-23T164051.111523Z.png"
  ],
  "duration_minutes": 6.7,
  "end": "2026-10-23T16:41:47Z",
  "frequency_mhz": 437.55,
  "ground_station_id": 5265,
  "id": 15271547,
  "max_altitude_deg": 86.0,
  "norad_cat_id": 25544,
  "observer": "edmundlimboen",
  "rise_azimuth_deg": 216.0,
  "sat_id": "XSKZ-5603-1870-9019-3066",
  "set_azimuth_deg": 34.0,
  "start": "2026-10-23T16:35:07Z",
  "station_altitude_m": 15.0,
  "station_latitude": 1.313,
  "station_longitude": 103.774,
  "station_name": "9V1SST",
  "station_url": "https://network.satnogs.org/stations/5265/",
  "status": "good",
  "transmitter_description": "Mode U - SSTV - Robot-36",
  "transmitter_downlink_mhz": 437.55,
  "transmitter_mode": "SSTV",
  "transmitter_type": "Transmitter",
  "transmitter_uuid": "bSPmbvvAavnj9XHMim8yEc",
  "url": "https://network.satnogs.org/observations/15271547/",
  "vetted_at": "",
  "waterfall_status": "unknown",
  "waterfall_url": "https://s3.eu-central-1.wasabisys.com/satnogs-network/data_obs/2026/10/23/16/15271547/waterfall_15271547_2026-10-23T16-35-07.png"
}
```

### List a satellite's transmitters

List the radio transmitters, transceivers and transponders a satellite carries, lowest downlink frequency first, with their frequencies in MHz, mode, data rate, uplink, licensed service and whether they are active.

**Inputs**

- Satellite (`satellite`, text, required): Pick a satellite, or type its NORAD ID (25544 for the ISS), its SatNOGS ID or its SatNOGS DB address.
- Status (`status`, text): Only transmitters with this status. Leave empty for all. One of: `active`, `inactive`, `invalid`.
- How many (`limit`, number): How many transmitters to return, up to 200. From 1 to 200. Default: `50`.

**Outputs**

- `count` (number): How many transmitters are in this result
- `matched_count` (number): How many transmitters matched, before the limit
- `norad_cat_id` (number): Its NORAD catalog number
- `sat_id` (text): Its SatNOGS ID
- `satellite_name` (text): The satellite whose transmitters these are
- `transmitters` (list): The transmitters, lowest downlink frequency first

**Example output**

```json
{
  "count": 1,
  "matched_count": 1,
  "norad_cat_id": 25544,
  "sat_id": "XSKZ-5603-1870-9019-3066",
  "satellite_name": "ISS",
  "transmitters": [
    {
      "alive": true,
      "baud": 1200.0,
      "citation": "https://spaceflight.nasa.gov/station/reference/radio/",
      "description": "Mode V APRS",
      "downlink_high_mhz": null,
      "downlink_low_mhz": 145.825,
      "frequency_violation": false,
      "iaru_coordination": "N/A",
      "invert": false,
      "mode": "AFSK",
      "norad_cat_id": 25544,
      "sat_id": "XSKZ-5603-1870-9019-3066",
      "satellite_name": "ISS",
      "service": "Unknown",
      "status": "active",
      "type": "Transceiver",
      "unconfirmed": false,
      "updated_at": "2019-06-16T08:49:33Z",
      "uplink_high_mhz": null,
      "uplink_low_mhz": 145.825,
      "uplink_mode": "AFSK",
      "uuid": "ZJxCeQmih9zDfYNVrB4wRN"
    }
  ]
}
```

### List ground stations

List the SatNOGS ground stations that are online (or testing), nearest first around a point or busiest first, with their position, antennas and bands, how many passes they have recorded and their success rate. Narrow by name, band and distance.

**Inputs**

- Status (`status`, text): Online stations (the default), or those their owners are testing. One of: `online`, `testing`. Default: `online`.
- Name contains (`name_contains`, text): Only stations whose name contains this text.
- Band (`band`, text): Only stations with an antenna for this band. Leave empty for any. One of: `HF`, `VHF`, `UHF`, `L` (L band), `S` (S band), `C` (C band).
- Near latitude (`latitude`, number): With longitude, list stations nearest this point first, such as 37.98 for Athens. From -90 to 90.
- Near longitude (`longitude`, number): With latitude, such as 23.73 for Athens. From -180 to 180.
- Within (km) (`radius_km`, number): Only stations within this many km of the point. Leave empty for any distance. From 0 to 20000.0.
- How many (`limit`, number): How many stations to return, up to 200. From 1 to 200. Default: `25`.

**Outputs**

- `count` (number): How many stations are in this result
- `matched_count` (number): How many stations matched, before the limit
- `stations` (list): The ground stations, nearest first when a point was given, else the busiest first
- `status` (text): The status listed: online or testing

**Example output**

```json
{
  "count": 1,
  "matched_count": 14,
  "stations": [
    {
      "altitude_m": 100.0,
      "antennas": [
        {
          "band": "UHF",
          "max_mhz": 440.0,
          "min_mhz": 429.999999,
          "type": "Turnstile"
        }
      ],
      "bands": [
        "UHF"
      ],
      "client_version": "2.1.4",
      "created_at": "2026-09-29T10:21:24Z",
      "description": "",
      "distance_km": 3.0,
      "future_observation_count": 21,
      "id": 5232,
      "image_url": "https://network-satnogs.freetls.fastly.net/media/ground_stations/8dba25c4-6e5c-497a-aa69-02823d76c9da.jpg",
      "last_seen_at": "2026-10-23T16:46:20Z",
      "latitude": 37.99922,
      "longitude": 23.706332,
      "min_horizon_deg": 10.0,
      "name": "yiami",
      "observation_count": 466,
      "owner": "yiami",
      "qth_locator": "KM17ux",
      "status": "Online",
      "success_rate_percent": 79.0,
      "url": "https://network.satnogs.org/stations/5232/"
    }
  ],
  "status": "online"
}
```

### List modes

List every modulation mode SatNOGS knows, such as FM, AFSK, BPSK or SSTV, alphabetically. A mode is what 'Search transmitters' and 'List observations' narrow to.

**Inputs**: None.

**Outputs**

- `count` (number): How many modes there are
- `modes` (list): Every mode, alphabetically

**Example output**

```json
{
  "count": 3,
  "modes": [
    {
      "id": 49,
      "name": "AFSK"
    },
    {
      "id": 50,
      "name": "BPSK"
    },
    {
      "id": 1,
      "name": "FM"
    }
  ]
}
```

### List observations

List satellite passes SatNOGS ground stations have recorded, newest first, for a satellite, a station or both, with their rating (good, bad, failed or not yet rated) and links to the waterfall, audio and decoded data. Narrow by mode and by when the pass began. SatNOGS answers about 60 of these lists an hour without an account, each up to 25 passes.

**Inputs**

- Satellite (`satellite`, text): Only passes of this satellite. Pick one, or type its NORAD ID (25544 for the ISS) or SatNOGS ID. Leave empty for any.
- Ground station (`ground_station`, text): Only passes at this ground station. Pick one, or type any station's ID. Leave empty for any.
- Rating (`status`, text): Only passes rated this way. Leave empty for any. One of: `good` (Good (signal received)), `bad` (Bad (no signal)), `failed` (Failed (not recorded)), `unknown` (Not rated yet).
- Mode (`mode`, text): Only passes listening for this mode, such as FM, SSTV or BPSK. Leave empty for any.
- Started after (`started_after`, date and time): Only passes that began at or after this time.
- Started before (`started_before`, date and time): Only passes that began before this time.
- How many (`limit`, number): How many passes to return, up to 100. Each 25 is one of the hour's observation lists. From 1 to 100. Default: `25`.

**Outputs**

- `count` (number): How many observations are in this result
- `more_available` (true/false): True when SatNOGS had more past the limit
- `observations` (list): The observations, most recent first

**Example output**

```json
{
  "count": 1,
  "more_available": true,
  "observations": [
    {
      "archive_url": "",
      "archived": false,
      "audio_url": "https://network-satnogs.freetls.fastly.net/media/data_obs/2026/10/23/16/15271547/satnogs_15271547_2026-10-23T16-35-07.ogg",
      "baud": null,
      "data_count": 1,
      "data_urls": [
        "https://s3.eu-central-1.wasabisys.com/satnogs-network/data_obs/2026/10/23/16/15271547/data_15271547_2026-10-23T164051.111523Z.png"
      ],
      "duration_minutes": 6.7,
      "end": "2026-10-23T16:41:47Z",
      "frequency_mhz": 437.55,
      "ground_station_id": 5265,
      "id": 15271547,
      "max_altitude_deg": 86.0,
      "norad_cat_id": 25544,
      "observer": "edmundlimboen",
      "rise_azimuth_deg": 216.0,
      "sat_id": "XSKZ-5603-1870-9019-3066",
      "set_azimuth_deg": 34.0,
      "start": "2026-10-23T16:35:07Z",
      "station_altitude_m": 15.0,
      "station_latitude": 1.313,
      "station_longitude": 103.774,
      "station_name": "9V1SST",
      "station_url": "https://network.satnogs.org/stations/5265/",
      "status": "good",
      "transmitter_description": "Mode U - SSTV - Robot-36",
      "transmitter_downlink_mhz": 437.55,
      "transmitter_mode": "SSTV",
      "transmitter_type": "Transmitter",
      "transmitter_uuid": "bSPmbvvAavnj9XHMim8yEc",
      "url": "https://network.satnogs.org/observations/15271547/",
      "vetted_at": "",
      "waterfall_status": "unknown",
      "waterfall_url": "https://s3.eu-central-1.wasabisys.com/satnogs-network/data_obs/2026/10/23/16/15271547/waterfall_15271547_2026-10-23T16-35-07.png"
    }
  ]
}
```

### List scheduled observations

List the passes SatNOGS ground stations are scheduled to record, soonest first, for a satellite, a station or both: when each begins and ends, the frequency and mode, and how high the satellite will rise.

**Inputs**

- Satellite (`satellite`, text): Only passes of this satellite. Pick one, or type its NORAD ID (25544 for the ISS) or SatNOGS ID. Leave empty for any.
- Ground station (`ground_station`, text): Only passes at this ground station. Pick one, or type any station's ID. Leave empty for any.
- Starting before (`starting_before`, date and time): Only passes that begin before this time. Leave empty for every scheduled pass.
- How many (`limit`, number): How many passes to return, up to 200. From 1 to 200. Default: `25`.

**Outputs**

- `count` (number): How many observations are in this result
- `matched_count` (number): How many scheduled observations matched, before the limit
- `observations` (list): The scheduled observations, soonest first

**Example output**

```json
{
  "count": 2,
  "matched_count": 206,
  "observations": [
    {
      "baud": null,
      "end": "2026-10-23T17:17:05Z",
      "frequency_mhz": 437.8,
      "ground_station_id": 2550,
      "id": 15271099,
      "max_altitude_deg": 18.0,
      "mode": "FM",
      "norad_cat_id": 25544,
      "satellite_name": "ISS",
      "start": "2026-10-23T17:07:18Z",
      "station_url": "https://network.satnogs.org/stations/2550/",
      "transmitter_uuid": "eozSf5mKyzNxoascs8V4bV",
      "url": "https://network.satnogs.org/observations/15271099/"
    },
    {
      "baud": null,
      "end": "2026-10-23T17:14:27Z",
      "frequency_mhz": 437.8,
      "ground_station_id": 754,
      "id": 15275192,
      "max_altitude_deg": 70.0,
      "mode": "FM",
      "norad_cat_id": 25544,
      "satellite_name": "ISS",
      "start": "2026-10-23T17:08:33Z",
      "station_url": "https://network.satnogs.org/stations/754/",
      "transmitter_uuid": "eozSf5mKyzNxoascs8V4bV",
      "url": "https://network.satnogs.org/observations/15275192/"
    }
  ]
}
```

### Search satellites

Find satellites in SatNOGS DB by name, other name, NORAD ID or SatNOGS ID, optionally only those in orbit, re-entered or still to launch. Each comes with its NORAD ID, status, launch and re-entry dates, countries, website and picture. Leave the search empty to list every satellite of a status.

**Inputs**

- Search (`query`, text): Text in the satellite's name or other names, or its NORAD or SatNOGS ID, such as ISS, FUNcube or 43017. Leave empty to list every satellite.
- Status (`status`, text): Only satellites with this status. Leave empty for any. One of: `in orbit`, `future` (Not launched yet), `re-entered`, `launch failed`.
- How many (`limit`, number): How many satellites to return, up to 200. From 1 to 200. Default: `25`.

**Outputs**

- `count` (number): How many satellites are in this result
- `matched_count` (number): How many satellites matched, before the limit
- `query` (text): The text searched for; empty when every satellite was listed
- `satellites` (list): The matching satellites, best match first
- `status` (text): The status the search was narrowed to; empty for any

**Example output**

```json
{
  "count": 1,
  "matched_count": 1,
  "query": "ISS",
  "satellites": [
    {
      "alternative_names": [
        "ZARYA",
        "RS0ISS",
        "NA1SS"
      ],
      "associated_satellites": [],
      "countries": [
        "RU",
        "US"
      ],
      "decayed_at": "",
      "deployed_at": "",
      "has_telemetry_decoder": true,
      "image_url": "https://db-satnogs.freetls.fastly.net/media/satellites/ISS.jpg",
      "is_frequency_violator": false,
      "launched_at": "1998-11-20T00:00:00Z",
      "name": "ISS",
      "norad_cat_id": 25544,
      "operator": "",
      "sat_id": "XSKZ-5603-1870-9019-3066",
      "status": "in orbit",
      "updated_at": "2025-08-01T05:17:04Z",
      "url": "https://db.satnogs.org/satellite/XSKZ-5603-1870-9019-3066",
      "website": "https://www.nasa.gov/mission_pages/station/main/index.html"
    }
  ],
  "status": "in orbit"
}
```

### Search transmitters

Find transmitters on any satellite by mode, downlink frequency range in MHz, status, type or licensed service, such as every active AFSK transmitter between 145 and 146 MHz. Each comes with its satellite's name and NORAD ID, lowest frequency first.

**Inputs**

- Mode (`mode`, text): Only transmitters whose downlink uses this mode, such as FM, AFSK or BPSK. Leave empty for any.
- Lowest frequency (MHz) (`min_frequency_mhz`, number): Only downlinks at or above this frequency in MHz, such as 145. From 0 to 300000.
- Highest frequency (MHz) (`max_frequency_mhz`, number): Only downlinks at or below this frequency in MHz, such as 146. From 0 to 300000.
- Status (`status`, text): Only transmitters with this status. Leave empty for any. One of: `active`, `inactive`, `invalid`.
- Type (`transmitter_type`, text): Only this kind of transmitter. Leave empty for any. One of: `Transmitter` (Transmitter (sends only)), `Transceiver` (Transceiver (sends and receives)), `Transponder` (Transponder (relays signals)).
- Service (`service`, text): Only transmitters licensed for this radio service, such as Amateur. Leave empty for any. One of: `Aeronautical`, `Amateur`, `Broadcasting`, `Earth Exploration`, `Fixed`, `Inter-satellite`, `Maritime`, `Meteorological`, `Mobile`, `Radiolocation`, and 5 more.
- How many (`limit`, number): How many transmitters to return, up to 200. From 1 to 200. Default: `25`.

**Outputs**

- `count` (number): How many transmitters are in this result
- `matched_count` (number): How many transmitters matched, before the limit
- `transmitters` (list): The matching transmitters, lowest downlink frequency first

**Example output**

```json
{
  "count": 2,
  "matched_count": 2,
  "transmitters": [
    {
      "alive": true,
      "baud": 1200.0,
      "citation": "CITATION NEEDED - https://xkcd.com/285/",
      "description": "PE0SAT - 1k2 AFSK APRS",
      "downlink_high_mhz": 145.8268,
      "downlink_low_mhz": 145.8268,
      "frequency_violation": false,
      "iaru_coordination": "N/A",
      "invert": false,
      "mode": "AFSK",
      "norad_cat_id": 26931,
      "sat_id": "MIOI-0494-0446-3367-1916",
      "satellite_name": "PCSAT",
      "service": "Unknown",
      "status": "active",
      "type": "Transmitter",
      "unconfirmed": false,
      "updated_at": "2019-04-18T05:39:53Z",
      "uplink_high_mhz": null,
      "uplink_low_mhz": null,
      "uplink_mode": "",
      "uuid": "v5NW6by7m6NoK7gC2XCGyF"
    },
    {
      "alive": true,
      "baud": 9600.0,
      "citation": "CITATION NEEDED - https://xkcd.com/285/",
      "description": "AFSK9k6 digital data",
      "downlink_high_mhz": 145.92,
      "downlink_low_mhz": 145.92,
      "frequency_violation": false,
      "iaru_coordination": "N/A",
      "invert": false,
      "mode": "AFSK",
      "norad_cat_id": 43770,
      "sat_id": "KHIK-6754-7801-4022-8938",
      "satellite_name": "FOX-1C",
      "service": "Unknown",
      "status": "active",
      "type": "Transmitter",
      "unconfirmed": false,
      "updated_at": "2019-04-18T05:39:53Z",
      "uplink_high_mhz": null,
      "uplink_low_mhz": null,
      "uplink_mode": "",
      "uuid": "aQiKaeWH7YPEMNgGo5Qg58"
    }
  ]
}
```
