# Video · render queue

`GET /v1/videos/generations` — List the workspace's render jobs of the last 24 hours.

- Base URL: https://eroq.ai/v1
- Auth: `Authorization: Bearer eroq_sk_…` (create keys at https://eroq.ai/dashboard/keys)
- Credits: free

Free to call. Returns every job the WORKSPACE submitted in the last 24 hours, newest first — teammates' renders included. This is exactly what the studio's topbar queue is built on.

List entries never carry inline base64 media: a succeeded job exposes `data` only when the clip lives at a URL. Fetch `GET /v1/videos/generations/{id}` for the full payload.

Finished entries carry `completed` (unix seconds) and `generation_ms` — the wall-clock the render took end-to-end.

## GET /v1/videos/generations

List the workspace's render jobs of the last 24 hours.

### Query parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | integer | no | Jobs to return, 1–50. Default 20. |
| `status` | string | no | Filter: `processing`, `succeeded` or `failed`. |

### Example request

```bash
curl "https://eroq.ai/v1/videos/generations?limit=20&status=processing" \
  -H "Authorization: Bearer $EROQ_API_KEY"
```

```javascript
const res = await fetch('https://eroq.ai/v1/videos/generations?limit=20&status=processing', {
  headers: { Authorization: `Bearer ${process.env.EROQ_API_KEY}` },
})
console.log(await res.json())
```

```python
import os, requests

res = requests.get("https://eroq.ai/v1/videos/generations?limit=20&status=processing", headers={"Authorization": f"Bearer {os.environ['EROQ_API_KEY']}"})
print(res.json())
```

```go
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://eroq.ai/v1/videos/generations?limit=20&status=processing", nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("EROQ_API_KEY"))

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
}
```

### Response


```json
{
  "object": "list",
  "data": [
    {
      "id": "b7e6c2d4-…",
      "object": "video.generation",
      "status": "processing",
      "created": 1756118400,
      "model": "seedance-2-0-mini",
      "duration": "5s",
      "prompt": "slow pan over a rooftop bar at dusk",
      "poll": "/v1/videos/generations/b7e6c2d4-…"
    },
    {
      "id": "a1f39e88-…",
      "object": "video.generation",
      "status": "succeeded",
      "created": 1756118100,
      "completed": 1756118238,
      "generation_ms": 138000,
      "model": "seedance-2-0-mini",
      "duration": "5s",
      "prompt": "a detective steps into the rain",
      "data": [{ "url": "https://cdn.eroq.ai/…/video.mp4?token=…&expires=…", "content_type": "video/mp4" }]
    }
  ]
}
```

---
Canonical: https://eroq.ai/docs/video-list · Index for agents: https://eroq.ai/llms.txt · OpenAPI: https://eroq.ai/openapi.json