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

# Get fleet results

> Poll an asynchronous fleet creation for ordered member results.

## Authentication

Send your scoped bearer token in the `Authorization: Bearer <BEAD_TOKEN>` header, or send your API key in `X-API-Key`.

## Parameters

**id** `string` *required*

UUID of the fleet operation. Format: `uuid`.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
curl --request GET \
  --url "https://api.bead.run/v2/sandboxes/fleets/$FLEET_ID" \
  --header "X-API-Key: $BEAD_API_KEY"
```

## Response

### 200

Current results for each requested machine.

**results** `object[]` *required*

One result per requested machine.

**Properties**

**index** `integer` *required*

Zero-based request index.

**status** `integer` *required*

HTTP status for this member; 202 means it is still pending.

**operationID** `string`

Operation UUID for a pending member.

**response** `object`

Machine connection fields on success, or an error body on failure. Accepts `object` or `object` or `object`.

**Properties**

**alias** `string`

Alias of the template

**clientID** `string` *deprecated*

Identifier of the client

**domain** `string | null`

Base domain where the sandbox traffic is accessible May be `null`.

**envdAccessToken** `string`

Access token used for envd communication

**envdVersion** `string`

Version of the envd running in the sandbox

**grace\_deadline** `string | null`

End of the credit grace period as an RFC 3339 timestamp, or null when funded. May be `null`.

**idle\_timeout** `integer | string | null`

Seconds without activity before a persistent machine pauses, or never to disable idle pause. Persistent machines default to 900 seconds; numeric values must be 300–86400. May be `null`. Accepts `integer` or `string` ("never").

**kind** `string`

Lifetime policy: temporary expires at its timeout; persistent retains state until explicit deletion or the end of credit grace. Allowed values: `"temporary"`, `"persistent"`.

**last\_activity** `string | null`

Most recent activity as an RFC 3339 timestamp, or null when no activity was recorded. May be `null`.

**machine\_state** `string`

Current lifecycle state including running, idle-paused, waking, credit-grace, lost, or deleted. Allowed values: `"running"`, `"idle-paused"`, `"waking"`, `"credit-grace"`, `"lost"`, `"deleted"`.

**paused\_at** `string | null`

Time the machine last paused as an RFC 3339 timestamp, or null when it has not paused. May be `null`.

**sandboxID** `string`

Identifier of the sandbox

**templateID** `string`

Identifier of the template from which is the sandbox created

**trafficAccessToken** `string | null`

Token required for accessing sandbox via proxy. May be `null`.

**wake\_reason** `string | null`

Reason for the last wake or lifecycle transition, or null when none is recorded. May be `null`.

**warnings** `object[]`

Lifecycle or credit grace warnings attached to this machine. Additional keys accept `any` values.

**code** `integer`

HTTP status code.

**message** `string`

Explanation of the failed request.

**error\_code** `string`

Stable error identifier when supplied; use it to decide how to recover.

**limit** `object`

The resource limit that blocked the request.

**Properties**

**limit** `string` *required*

Name of the exhausted resource.

**maximum** `integer` *required*

Allowed amount of this resource.

**usage** `integer` *required*

Current usage counted against the limit.

**next\_action** `string` *required*

Action you can take to proceed.

**reset\_at** `integer`

Unix time in seconds when this time window resets.

**operationID** `string`

Operation UUID.

**status** `string`

Current operation state.

**fleetID** `string` *required*

Fleet UUID supplied in the polling URL.

**status** `string` *required*

Whether every member has finished. Allowed values: `"pending"`, `"completed"`.

## Errors

| Status | Meaning |
| - | - |
| 400 | Invalid resource UUID or request parameters. |
| 401 | Authentication credential is missing or rejected. |
| 403 | The credential lacks the required scope. |
| 404 | The requested resource does not exist or is outside your organization. |
| 429 | Request or resource admission limit exceeded (`admission_limit`). Follow limit.next\_action and Retry-After when present. |
| 503 | Service or persistence is temporarily unavailable. |


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