Dataset Statistics

GET/datasets/stats

Retrieve comprehensive statistics for all datasets in your organization, including breakdowns by status, data type, and daily volume.

Headers

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

Example Request

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

Response

{
  "total_datasets": 42,
  "total_size_bytes": 10737418240,
  "by_status": {
    "pending": 5,
    "accepted": 30,
    "rejected": 2,
    "for_admin_review": 3,
    "superseded": 1,
    "discarded": 1
  },
  "by_data_type": {
    "episode": 20,
    "synthetic_pov": 15,
    "synthetic_third_person": 7
  },
  "daily_volume_last_7_days": [
    { "date": "2025-01-15", "count": 3 },
    { "date": "2025-01-14", "count": 5 },
    { "date": "2025-01-13", "count": 2 },
    { "date": "2025-01-12", "count": 0 },
    { "date": "2025-01-11", "count": 1 },
    { "date": "2025-01-10", "count": 4 },
    { "date": "2025-01-09", "count": 2 }
  ]
}

Response Fields

Field	Type	Description
`total_datasets`	integer	Total number of datasets
`total_size_bytes`	integer	Combined size of all datasets in bytes
`by_status`	object	Count of datasets by status
`by_data_type`	object	Count of datasets by data type
`daily_volume_last_7_days`	array	Daily dataset creation count for past 7 days

Status Breakdown

Status	Description
`pending`	Awaiting your review
`accepted`	Approved for use
`rejected`	Rejected by your organization
`for_admin_review`	Being reviewed by Gerra team
`superseded`	Replaced by a newer version
`discarded`	Discarded by Gerra team

Data Type Breakdown

Type	Description
`episode`	Real robot deployment recordings
`synthetic_pov`	AI-generated first-person video
`synthetic_third_person`	AI-generated third-person video

Error Responses

Status	Description
`401`	Missing or invalid `Gerra-Api-Key` header

Dataset Statistics

On this page