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

# List instances

> List your workspace's instances, newest first.

<RequestExample>
  ```bash curl wrap theme={null}
  curl -X GET \
    https://api.agent37.com/v1/instances \
    -H "Authorization: Bearer sk_live_..."
  ```

  ```python Python wrap theme={null}
  import requests

  response = requests.get(
      "https://api.agent37.com/v1/instances",
      headers={
          "Authorization": "Bearer sk_live_..."
      },
  )
  response.raise_for_status()
  print(response.json())
  ```

  ```javascript Node wrap theme={null}
  const response = await fetch(
    "https://api.agent37.com/v1/instances",
    {
      method: "GET",
      headers: {
        "Authorization": "Bearer sk_live_..."
      },
    },
  );
  if (!response.ok) {
    throw new Error(await response.text());
  }
  console.log(await response.json());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 (excerpt) wrap theme={null}
  {
    "data": [
      {
        "id": "ab12cd34ef",
        "status": "running",
        "url": "https://ab12cd34ef.agent37.app"
      }
    ]
  }
  ```
</ResponseExample>

Authenticate with `Authorization: Bearer sk_live_...` on `https://api.agent37.com`.

## Response

`200` with `{ "data": [...] }`. Each item is the full [instance object](/docs/agents-api/instances/object); the example shows selected fields.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.