> ## 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.

# Get an instance

> Read an instance's status, resources, and URLs.

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

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

  response = requests.get(
      "https://api.agent37.com/v1/instances/ab12cd34ef",
      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/ab12cd34ef",
    {
      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}
  {
    "id": "ab12cd34ef",
    "status": "running",
    "url": "https://ab12cd34ef.agent37.app"
  }
  ```
</ResponseExample>

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

## Path parameters

<ParamField path="id" type="string" required>
  The instance id, returned when you create an instance.
</ParamField>

## Response

`200`. The response contains the full [instance object](/docs/agents-api/instances/object), including its resources, URLs, and timestamps. The example shows selected fields. Unknown, deleted, or other-workspace ids return `404 not_found`.


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