These endpoints provide access to project information, useful for organizations with multiple projects.
Satelligence API (v1)
The satelligence API provides 4 capabilities to synchronize data to and from the platform:
- Bulk uploads
A full fledged set of endpoints to manage supply chain data in the platform. Use this endpoint to set up automated data synchronization of supply chain data to the Satelligence platform and fully leverage the risk assessment and mitigation features inside the platform.
- Plot downloads
An endpoint that can serve to sync plot data from the platform into your own systems. It can serve both plot metadata, geometries, and risk assessments from the platform.
- Jurisdictions new!
Access jurisdiction-level deforestation risk assessments for administrative regions worldwide. Filter by country, risk level, and regulatory framework cutoff date (EUDR, RSPO, etc.) to get pre-computed values and risk information.
- Get Risk Info
A lightweight endpoint to access geospatial risk information for a given boundary without uploading supply chain data to the platform. Use this endpoint to leverage the Satelligence geospatial data but build your own risk assessment and mitigation strategies outside of the Satelligence platform.
Authentication requires an API token, contact support@satelligence.com to request one. To authenticate your requests, set the Authorization: Bearer $token header in your requests.
The token is connected to a personal account, it will have the same permissions as the account that created it. If the linked user belongs to multiple projects, the token will default to the 'active project' for that user.
Languages
Servers
Mock server
https://docs.satelligence.com/_mock/api/
Production server
https://api.satelligence.com/
Bulk Uploads
These endpoints give full control over supply chain data uploads and ingestion.
For a bulk upload, plots must be formatted as a GeoJSON file and uploaded to a secure location in Satelligence's Google Cloud Storage bucket through a signed URL. The complete process consists of three steps:
- Create a bulk upload with the POST
/bulk-uploadsendpoint, which generates signed URLs for each file you want to upload. - Use the signed URLs to upload the files to the required place for this upload.
- Start the bulk upload with the POST
/bulk-uploads/startendpoint.
The process can be automated with the scripts linked here.
Operations
Jurisdictions - New!
These endpoints provide access to jurisdiction-level deforestation risk assessments. Jurisdictions are administrative regions for which risk assessments were pre-computed for different regulatory frameworks. For more information, visit the Resource Center page on Jurisdictions.
Operations