Usage Monitoring overview
About
Monitor and track your usage of Leaf's services. Usage tracking measures data processing activities - not API access. You have unlimited API calls to retrieve your processed data.
All HTTP methods should be prepended by this service's endpoint:
What Gets Tracked
Each service tracks area differently with these product identifiers:
| Product ID | What It Tracks | When to Use |
|---|---|---|
FIELDS_BOUNDARY | Boundary processing during contract period | Field boundary usage monitoring and billing |
AUDIT_FIELDS_BOUNDARY | Current total boundary area | Understanding total area with Leaf |
OPERATIONS_FILE | Machine files processed during contract period | Raw machine data processing usage monitoring |
OPERATIONS_OPERATION | Operations processed during the contract period based on machine files intersecting boundaries | Field-specific operations usage monitoring and billing |
SATELLITE_PROCESS_PLANET | Planet satellite imagery procssed during the contract period | Planet satellite usage monitoring and billing |
SATELLITE_PROCESS_SENTINEL | Sentinel satellite imagery processed during the contract period | Sentinel satellite usage monitoring and billing |
You pay for Leaf to process your data, not access it. Once processed, you have unlimited API access to it for the duration of your contract.
Area is counted when Leaf successfully processes your data (not during uploads or if processing fails). Deleted boundaries count in the current contract term only.
Contracts
Contracts are automatically generated when you start using Leaf services. Each contract tracks usage for one product type (like FIELDS_BOUNDARY or OPERATIONS_FILE) with annual cycles.
Finding Your Contracts: Call GET /billing/contracts to see available contracts with their IDs and tracked services.
API Owner vs Leaf User Level Tracking
- API Owner Level: Shows unique spatial area across all users (removes overlaps) for a given api owner
- Leaf User Level: Shows individual user processing (includes overlaps, used for billing)
The difference between these totals indicates spatial overlap - useful for identifying data duplication across your organization.