Skip to content

Satellogic API v2 Overview

The Satellogic API v2 represents a comprehensive evolution of our satellite imagery platform, providing enterprise-grade access to satellite data products, sophisticated order management, and advanced analytics capabilities. This modern RESTful API enables developers to seamlessly integrate satellite imagery workflows into their applications with complete lifecycle visibility and control.

🚀 What's New in API v2

Enhanced Architecture

  • Unified Interface: Single API for both archive and tasking operations
  • Event-Driven Design: Complete audit trails and real-time status updates
  • State Machine Management: Predictable order and deliverable lifecycle tracking
  • Standards Compliance: Full STAC API compatibility for archive search

Advanced Features

  • Bulk Operations: Handle multiple targets efficiently in single requests
  • Capture Tracking: Detailed satellite collection monitoring for tasking orders
  • Consumption Analytics: Comprehensive usage reporting and billing insights
  • Enterprise Security: OAuth2 authentication with contract-based access control

🎯 Core Capabilities

1. Archive Search & Discovery

Browse and discover historical satellite imagery using industry-standard STAC (SpatioTemporal Asset Catalog) specifications:

  • STAC-Compliant Search: Filter by geometry, datetime, collections, and custom properties
  • Multi-Format Support: Access data in various processing levels (L0 through L1D_SR)
  • Metadata-Rich Results: Comprehensive asset information with download links
  • Pagination Support: Efficient handling of large result sets

2. Tasking Analysis & Planning

Analyze future capture opportunities before placing orders:

  • Opportunity Analysis: Evaluate feasibility for specific targets and timeframes
  • Constraint Validation: Check sun elevation, off-nadir angles, and temporal requirements
  • Mission Planning: Optimize satellite tasking for geographic targets
  • Coverage Assessment: Understand potential satellite availability

3. Advanced Order Management

Sophisticated lifecycle management through well-defined state machines:

Order States

  • Received: Initial processing and feasibility analysis
  • In Progress: Active work on generating deliverables
  • Closed: Order completion or cancellation

Capture States (Tasking Orders)

  • Queued: Capture scheduled with parameters and satellite assignment
  • Collecting: Collection in progress, satellite plan locked
  • Acquired: Imagery successfully collected and QC-passed
  • Failed: Collection attempt unsuccessful

Deliverable States

  • Processing: Imagery being processed and packaged
  • Delivered: Product ready for consumption
  • Not Delivered: Processing failed or off-specification

4. Event-Driven Monitoring

Complete visibility into order and deliverable lifecycles:

  • Order Events: Track order progression with detailed timestamps
  • Capture Events: Monitor satellite collection activities in real-time
  • Deliverable Events: Visibility into processing pipeline and quality control
  • Failure Diagnostics: Comprehensive error reporting for troubleshooting

5. Consumption Analytics

Monitor and analyze data usage patterns:

  • Multi-Level Reporting: Organization, contract, and user-level insights
  • Usage Metrics: Track consumption across different processing levels
  • Export Capabilities: Generate reports in multiple formats
  • Billing Integration: Detailed metrics for cost management

🔧 API Structure

The API is organized into logical functional groups:

Profile Management

  • User authentication and profile information
  • API credential management
  • Contract access and permissions

Search & Browsing

  • Archive: STAC-compliant historical imagery search
  • Tasking: Opportunity analysis and feasibility assessment

Ordering

  • Order creation for archive and tasking products
  • Complete lifecycle management with state tracking
  • Deliverable and capture monitoring
  • Event history and audit trails

Consumption

  • Usage analytics and reporting
  • Multi-level consumption insights
  • Data export capabilities

🛡️ Security & Authentication

OAuth2 Implementation

  • Enterprise-grade authentication
  • Granular permission scopes
  • Secure token-based access

Multi-Tenant Architecture

  • Contract-based data isolation
  • Organization-level access control
  • User permission management

📊 Standards Compliance

Industry Standards

  • STAC API: SpatioTemporal Asset Catalog specifications
  • GeoJSON: Spatial data representation
  • REST: Resource-oriented design with predictable HTTP methods
  • OpenAPI 3.0: Complete API specification documentation

Data Formats

  • GeoJSON for spatial queries and responses
  • Standard HTTP status codes
  • JSON for all API interactions
  • ISO 8601 datetime formats

🚦 Getting Started

1. Authentication Setup

# Obtain API credentials through your Satellogic account
# Configure OAuth2 authentication
# Select appropriate contract for your needs

2. Explore Archive Data

# Search historical imagery using STAC endpoints
GET /archive/search?collections=quickview-visual&bbox=-74,40,-73,41

3. Analyze Tasking Opportunities

# Submit opportunity analysis for future collections
POST /analysis/opportunities

4. Create Orders

# Place orders for archive or tasking products
POST /orders

5. Monitor Progress

# Track order status through events
GET /orders/{order_id}/events

🔄 Migration from API v1

For existing API v1 users, we provide:

  • Migration Guide: Step-by-step transition instructions
  • Compatibility Layer: Gradual migration support
  • Enhanced Features: Access to new capabilities not available in v1
  • Performance Improvements: Faster response times and better reliability

📞 Support & Resources

  • API Documentation: Complete OpenAPI specification with examples
  • Code Samples: Python, JavaScript, and cURL examples
  • Support Team: Technical assistance for integration
  • Status Page: Real-time API health and status updates

🎯 Use Cases

Earth Observation Applications

  • Environmental monitoring and change detection
  • Agricultural crop monitoring and yield prediction
  • Urban planning and infrastructure development
  • Disaster response and emergency management

Enterprise Solutions

  • Supply chain monitoring
  • Insurance and risk assessment
  • Government and defense applications
  • Research and scientific studies

The Satellogic API v2 empowers developers to build sophisticated applications that leverage the full potential of satellite imagery with enterprise-grade reliability, comprehensive monitoring, and advanced analytics capabilities.