Get Dataset

GET/datasets/dataset

Retrieve a single dataset by ID with a pre-signed download URL. The download URL is valid for 60 minutes and provides authenticated access to the dataset file.

Query Parameters

Parameter	Type	Required	Description
`id`	string	Yes	Dataset ID (UUID)

Headers

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

Example Request

curl "https://api.gerra.com/datasets/dataset?id=770e8400-e29b-41d4-a716-446655440000" \
  -H "Gerra-Api-Key: gerra_1234567890abcdef"

Response

{
  "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 during Q1 operations",
  "status": "pending",
  "link": "datasets/robot-arm-q1-2025.zip",
  "signed_url": "https://storage.example.com/datasets/robot-arm-q1-2025.zip?token=xyz123...",
  "data_byte_size": 257355776,
  "metadata": {
    "episode": 1,
    "location": "factory_floor_3",
    "sensor_type": "thermal"
  }
}

Response Fields

Field	Type	Description
`id`	string	Dataset ID (UUID)
`date_created`	string	ISO 8601 creation timestamp
`date_updated`	string	ISO 8601 last update timestamp
`organization_id`	string	Organization ID
`data_type`	string	Type of data
`name`	string	Dataset name
`description`	string	Description (may be null)
`status`	string	Current status
`link`	string	Storage path
`signed_url`	string	Pre-signed download URL (60 min expiry)
`data_byte_size`	integer	File size in bytes
`metadata`	object	Custom metadata

Downloading the Dataset

Use the signed_url to download the dataset file:

# Download to local file
curl -o dataset.zip "$SIGNED_URL"

Error Responses

Status	Description
`401`	Missing or invalid `Gerra-Api-Key` header
`403`	Dataset does not belong to your organization
`404`	Dataset not found
`422`	Invalid or missing `id` parameter

Example Error Response

{
  "detail": "Dataset does not belong to your organization"
}

Get Dataset

On this page