Quick Start

Get started with the Gerra Enterprise Platform in minutes.

Authentication

All API requests require your API key in the Gerra-Api-Key header. You can find your API key in your dashboard.

Gerra-Api-Key: gerra_your_api_key

1. List your organization's datasets

Use the API key to fetch datasets available to your organization.

curl "https://api.gerra.com/datasets" \
  -H "Gerra-Api-Key: YOUR_API_KEY"

2. Get a specific dataset with download URL

Retrieve a single dataset to get its pre-signed download URL (valid for 60 minutes).

curl "https://api.gerra.com/datasets/dataset?id=DATASET_ID" \
  -H "Gerra-Api-Key: YOUR_API_KEY"

3. Accept or reject datasets

Review pending datasets and update their status.

# Accept a dataset
curl -X POST "https://api.gerra.com/datasets/DATASET_ID/accept" \
  -H "Gerra-Api-Key: YOUR_API_KEY"

# Reject a dataset with reason
curl -X POST "https://api.gerra.com/datasets/DATASET_ID/reject" \
  -H "Gerra-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Quality issues in frames 120-150"}'

Next Steps

Explore the full API reference:

Datasets API Overview - Full reference for all endpoints
Accept/Reject Workflow - Detailed review workflow