# Ask the provider about a Sandbox now

Source: <https://everruns.com/docs/api/operations/get_sandbox_provider_state/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Operations & billing](https://everruns.com/docs/api/groups/operations-billing/)/Ask the provider about a Sandbox now

# Ask the provider about a Sandbox now

Preview

Ask the Sandbox’s provider (Daytona, E2B, Modal, boxd, Kubernetes) what it reports now: its state, errors, last activity and its own idle stop and delete settings. Read-only; organization admins only. Secrets in the provider’s record are never returned.

Public APIEverruns Cloud and self-hosted Platform

GET`/v1/sandboxes/{id}/provider`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Parameters

### Path Parameters

**id**

required

string

Prefixed public identifier

## Responses

200Success

### 200

Success

Media typeapplication/json

What the provider reports about the sandbox now. Built from an allowlist of fields; never the provider’s raw object.

object

**active**

Whether it holds compute (and so bills for it), when known.

boolean | null

**auto_archive_minutes**

integer | null format: int64

**auto_delete_minutes**

integer | null format: int64

**auto_stop_minutes**

The provider’s own idle stop in minutes (0 is off). It acts on its own, independently of Everruns’ idle pause.

integer | null format: int64

**checked_at**

required

string format: date-time

**created_at**

string | null format: date-time

**desired_state**

string | null

**details**

required

Size, region, image and similar non-secret details.

object

**_key_**

additional properties

string

**ends_at**

When the provider ends the sandbox on its own.

string | null format: date-time

**error**

The provider’s own error or exit reason.

string | null

**exists**

required

Whether the provider still knows the sandbox.

boolean

**external_id**

required

string

**labels**

required

Labels Everruns set on it.

object

**_key_**

additional properties

string

**last_activity_at**

string | null format: date-time

**provider**

required

string

**recoverable**

boolean | null

**state**

required

Provider-native state, such as `started`, `stopped` or `archived`.

string

**updated_at**

string | null format: date-time

### Example

```json
{
  "provider": "daytona",
  "state": "stopped"
}
```

404Sandbox not found

### 404

Sandbox not found

503The provider could not be asked

### 503

The provider could not be asked

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/sandboxes/example/provider';
const options = {method: 'GET'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request GET \
  --url https://app.everruns.com/api/v1/sandboxes/example/provider
```

Additional language examples require JavaScript. The default request example is available above.

200404503

200 · Success

```json
{
  "checked_at": "2026-10-12T09:00:00Z",
  "details": {},
  "exists": true,
  "external_id": "string",
  "labels": {},
  "provider": "daytona",
  "state": "stopped"
}
```

404 · Sandbox not found

No response body example is declared for this status.

503 · The provider could not be asked

No response body example is declared for this status.

## Matching endpoints