List Datasets

GET/datasets

Retrieve all datasets for your organization with optional filtering by data type, status, and metadata.

Query Parameters

Parameter	Type	Required	Default	Description
`data_type`	string	No	-	Filter by data type (episode, synthetic_pov, etc.)
`status`	string	No	-	Filter by status (pending, accepted, rejected)
`metadata`	string	No	-	Filter by metadata key:value (can specify multiple)
`limit`	integer	No	100	Number of results (max: 1000)
`offset`	integer	No	0	Number of results to skip

Headers

Header	Required	Description
`Gerra-Api-Key`	Yes	Your API key

Example Requests

Basic Request

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

Filter by Status

Get only pending datasets awaiting review:

curl "https://api.gerra.com/datasets?status=pending" \
  -H "Gerra-Api-Key: gerra_1234567890abcdef"

Filter by Data Type

Get only episode recordings:

curl "https://api.gerra.com/datasets?data_type=episode" \
  -H "Gerra-Api-Key: gerra_1234567890abcdef"

Filter by Metadata

Find datasets with specific metadata values:

# Single metadata filter
curl "https://api.gerra.com/datasets?metadata=sensor_type:thermal" \
  -H "Gerra-Api-Key: gerra_1234567890abcdef"

# Multiple metadata filters (AND logic)
curl "https://api.gerra.com/datasets?metadata=location:factory&metadata=shift:morning" \
  -H "Gerra-Api-Key: gerra_1234567890abcdef"

Pagination

# Page 1 (first 50 results)
curl "https://api.gerra.com/datasets?limit=50&offset=0" \
  -H "Gerra-Api-Key: gerra_1234567890abcdef"

# Page 2 (results 51-100)
curl "https://api.gerra.com/datasets?limit=50&offset=50" \
  -H "Gerra-Api-Key: gerra_1234567890abcdef"

Response

{
  "datasets": [
    {
      "id": "770e8400-e29b-41d4-a716-446655440000",
      "date_created": "2025-01-15T10:30:00Z",
      "date_updated": "2025-01-15T14:45:00Z",
      "organization_id": "660e8400-e29b-41d4-a716-446655440000",
      "data_type": "episode",
      "name": "Robot Arm Sensor Data Q1 2025",
      "description": "Telemetry data from robot arm sensors",
      "status": "pending",
      "link": "datasets/robot-arm-q1-2025.zip",
      "data_byte_size": 257355776,
      "metadata": {
        "sensor_type": "thermal",
        "location": "factory_floor_3"
      }
    }
  ],
  "total": 42
}

Response Fields

Field	Type	Description
`datasets`	array	Array of dataset objects
`total`	integer	Total number of datasets matching the query

Error Responses

Status	Description
`401`	Missing or invalid `Gerra-Api-Key` header
`422`	Invalid query parameters

List Datasets

On this page