> ## Documentation Index
> Fetch the complete documentation index at: https://docs.estudjo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Poll Generation Status and Retrieve Results | estudjo

> Use GET /status to track an estudjo generation from queued to completed and retrieve the finished image or video URL from result_urls.

Generations in estudjo are asynchronous. After queuing a job with `POST /generate` you receive a `task_id`. Use `GET /status` to check progress and retrieve the download URL once the generation is complete.

```text theme={null}
GET https://v1.api.estudjo.com/status?taskId={task_id}
```

<Info>
  Typical completion time is **10–100 seconds** depending on model and resolution. Poll every **5–10 seconds** — do not long-poll or send requests in rapid succession.
</Info>

## Status Values

A generation moves through up to three states:

<AccordionGroup>
  <Accordion title="pending — still processing">
    The job is in the queue or actively being generated.

    ```json theme={null}
    {
      "data": {
        "status": "pending"
      }
    }
    ```
  </Accordion>

  <Accordion title="completed — ready to download">
    The generation finished successfully. Use the URLs in `result_urls` to access your files.

    ```json theme={null}
    {
      "data": {
        "status": "completed",
        "result_urls": [
          "https://storage.estudjo.com/generations/6bfd652d4c31261ffb8ed3424ac2775e/result.jpeg"
        ]
      }
    }
    ```
  </Accordion>

  <Accordion title="failed — generation did not complete">
    Something went wrong upstream. Check `error_message` for details and retry if appropriate.

    ```json theme={null}
    {
      "data": {
        "status": "failed",
        "error_message": "..."
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## About `result_urls`

The URLs in `result_urls` are **permanent, public-read** links hosted on estudjo's own object storage. Do not use them directly in your application (e.g. in an `<img>` or `<video>` tag), download the files and store them in your own infrastructure. Generated files are available for download for 72 hours.

## Polling Examples

<CodeGroup>
  ```python poll.py theme={null}
  import time, requests

  API_KEY = "YOUR_API_KEY"
  TASK_ID = "6bfd652d4c31261ffb8ed3424ac2775e"

  while True:
      r = requests.get(
          f"https://v1.api.estudjo.com/status?taskId={TASK_ID}",
          headers={"X-Api-Key": API_KEY}
      )
      data = r.json()["data"]
      if data["status"] == "completed":
          print("Done:", data["result_urls"])
          break
      elif data["status"] == "failed":
          print("Failed:", data.get("error_message"))
          break
      time.sleep(5)
  ```

  ```javascript poll.js theme={null}
  async function pollStatus(taskId, apiKey) {
    while (true) {
      const res = await fetch(
        `https://v1.api.estudjo.com/status?taskId=${taskId}`,
        { headers: { 'X-Api-Key': apiKey } }
      );
      const { data } = await res.json();
      if (data.status === 'completed') return data.result_urls;
      if (data.status === 'failed') throw new Error(data.error_message);
      await new Promise(r => setTimeout(r, 5000));
    }
  }
  ```
</CodeGroup>

## Error Reference

| Code        | HTTP | Cause                                                         |
| ----------- | ---- | ------------------------------------------------------------- |
| `not_found` | 404  | The `taskId` does not exist or belongs to a different account |