# LeoLabs

> LeoLabs is a commercial space situational awareness company. It operates a global network of phased-array radars and a cloud analytics platform that independently tracks more than 23,000 objects in low Earth orbit, and sells that "Persistent Orbital Intelligence" — catalog, orbital state vectors, conjunction alerts, maneuver detection, pattern-of-life analysis, launch support — to satellite operators, insurers, and defense and civil space agencies.

Data reaches customers two ways: the LeoLabs Platform web interface, and what LeoLabs describes as "a suite of full-featured RESTful APIs for ground system integration and automation at scale."

Provenance note for agents: this file was GENERATED by API Evangelist from public LeoLabs surfaces and from LeoLabs' own published Python client. LeoLabs does not serve an llms.txt (404 on every host probed) and its reference documentation at docs.leolabs.space is behind a customer login, so the API description in this repo is derived, not official. Verify against LeoLabs before relying on it operationally.

## API

- [LeoLabs Platform API v1](https://api.leolabs.space/v1): REST/JSON API over the LeoLabs LEO catalog — catalog objects, radar measurements, orbital state vectors, TLEs, ephemeris propagation, planned passes, and radar tasking.
- Authentication: a LeoLabs access key + secret key pair, sent as `Authorization: basic <accessKey>:<secretKey>`. This is NOT RFC 7617 HTTP Basic — the keys are colon-joined and sent unencoded. Keys are issued from the LeoLabs Platform.
- Versioning: URI path, currently `v1`. No public deprecation policy, status page, changelog or SLA.
- Errors: plain JSON with a top-level `error` member. Not RFC 9457.
- Pagination: none observed. Narrow result sets with `startTime`/`endTime` or `latest=1` instead.
- Idempotency: not supported or documented. The two POST operations create tasking requests and a retry is expected to create a duplicate.

## Core operations

- `listCatalogObjects` — GET /catalog/objects
- `searchCatalogObjects` — GET /catalog/objects/search?noradCatalogNumber={n}
- `getCatalogObject` — GET /catalog/objects/{catalogNumber}
- `listCatalogObjectMeasurements` — GET /catalog/objects/{catalogNumber}/measurements
- `listCatalogObjectStates` — GET /catalog/objects/{catalogNumber}/states
- `getCatalogObjectState` — GET /catalog/objects/{catalogNumber}/states/{stateId}
- `listCatalogObjectStateTles` — GET /catalog/objects/{catalogNumber}/states/{stateId}/tles
- `getCatalogObjectStatePropagation` — GET /catalog/objects/{catalogNumber}/states/{stateId}/propagations
- `listCatalogObjectPlannedPasses` — GET /catalog/objects/{catalogNumber}/passes/planned
- `getCatalogObjectStatistics` — GET /catalog/objects/{catalogNumber}/statistics
- `createCatalogObjectTask` — POST /catalog/objects/{catalogNumber}/tasks (WRITE: commits radar capacity)
- `listInstruments` — GET /instruments
- `getInstrument` — GET /instruments/{instrumentId}
- `getInstrumentStatistics` — GET /instruments/{instrumentId}/statistics
- `listInstrumentTasks` — GET /instruments/{instrumentId}/tasks
- `createInstrumentTask` — POST /instruments/{instrumentId}/tasks (WRITE: commits radar capacity)
- `getInstrumentTask` — GET /instruments/{instrumentId}/tasks/{taskId}
- `listInstrumentTaskMeasurements` — GET /instruments/{instrumentId}/tasks/{taskId}/measurements

Identifiers: LeoLabs catalog numbers are `L`-prefixed (e.g. `L335` = ENVISAT, NORAD 27386). Instruments are short site codes (e.g. `pfisr`, `msr`). The literal `all` substitutes for an id on the states, planned-passes and statistics endpoints.

## Client libraries

- [leolabs (PyPI)](https://pypi.org/project/leolabs/): the official LeoLabs Python client and `leolabs` CLI. `pip install leolabs --upgrade`. First-party (author "LeoLabs, Inc.") but unmaintained — last released 2018-11-06, and its linked source repository now 404s.

## Human surfaces

- [LeoLabs](https://www.leolabs.space/): company site.
- [LeoLabs Platform](https://platform.leolabs.space/): sign-in, web interfaces, API key issuance.
- [Live visualization](https://platform.leolabs.space/visualization): public LEO visualization.
- [Documentation](https://docs.leolabs.space/): customer documentation — login required.
- [Newsroom](https://www.leolabs.space/newsroom/): news and announcements (RSS at /newsroom/feed/).
- [Vulnerability disclosure policy](https://www.leolabs.space/vulnerability-disclosure/): security@leolabs.space, safe harbor, 72-hour validation, 30/90/180-day remediation targets.
- [Terms of use](https://www.leolabs.space/terms-of-use/) · [Privacy policy](https://www.leolabs.space/privacy-policy/)
- Support: support@leolabs.space

## Optional

- [API Evangelist profile](https://raw.githubusercontent.com/api-evangelist/leo-labs/refs/heads/main/apis.yml): the APIs.json index for this provider, with the derived OpenAPI, authentication, conventions, error, data-model, lifecycle and conformance artifacts.