---
title: "Get a site's runtime"
url: https://docs.corefinity.com/api/reference/runtime/get-runtime
type: endpoint
last_updated: 2026-11-13
feature: php-runtime
related:
  - https://docs.corefinity.com/guides/sites/software-and-services/php-version.md
  - https://docs.corefinity.com/mcp/tools/corestack_runtime_get.md
---
# Get a site's runtime

Answers whether the site is on the runtime, the versions it runs, the last change of each part, anything
waiting for the site's window and whether the site can move onto the runtime.

```http
GET /api/corestack/sites/{site}/runtime
```

- Scope: `read`
- Two-factor: required on your account (all)
- Rate limit: 60 a minute
- Try it in the console: on

## Path parameters

- `site` (integer, required): The id of a site row. A website's production site and each of its environments has its own id. Digits only.

## Request

### curl

```bash
curl https://manage.corefinity.com/api/corestack/sites/1042/runtime \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
```

### PHP

```php
use Illuminate\Support\Facades\Http;

$response = Http::withToken(env('COREFINITY_TOKEN'))
    ->acceptJson()
    ->get('https://manage.corefinity.com/api/corestack/sites/1042/runtime');

$data = $response->json();
```

### Node

```javascript
const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/runtime', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
    Accept: 'application/json',
  },
});

// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);
```

### Python

```python
import os
import requests

res = requests.get(
    "https://manage.corefinity.com/api/corestack/sites/1042/runtime",
    headers={
        "Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
        "Accept": "application/json",
    },
)

data = res.json() if res.content else None
```

## Responses

### 200 The runtime summary.

```json
{
  "adopted": true,
  "adoption": {
    "adopt_now_refusal": null,
    "adopted": true,
    "can_adopt_now": false,
    "can_adopt_tonight": false,
    "in_progress": false,
    "planned_for": null,
    "queued_for": null,
    "revision": "v1"
  },
  "handover": false,
  "hot_apply": {
    "nginx": true,
    "node": true,
    "php": true
  },
  "images": {
    "nginx": {
      "revision": null,
      "version": null
    },
    "node_toolchain": {
      "major": null,
      "revision": null,
      "status": null
    },
    "php": {
      "current": true,
      "latest_round": 1,
      "minor": "8.4",
      "patch": "8.4.9",
      "round": 1,
      "superseded_since": null
    }
  },
  "last_apply": {
    "nginx": null,
    "node": null,
    "php": null
  },
  "new_relic": {
    "app": null,
    "state": "none"
  },
  "pending": [],
  "queued_for": null,
  "revision": "v1",
  "window_only": true
}
```

### 401 No token, or a token that is not valid.

```json
{
  "message": "Unauthenticated."
}
```

### 403 The token lacks the scope (`scope_required`, with the `scope` to use), or your company requires two-factor authentication and you have not set it up. For routes outside Managed Clusters.

```json
{
  "code": "company_unavailable",
  "message": "Your company is unavailable.",
  "reason": "company_unavailable"
}
```

### 404 The id does not exist or is something you cannot see, or the feature is not on for your company (`feature_off`).

```json
{
  "code": "feature_off",
  "message": "Not found.",
  "reason": "feature_off"
}
```

### 429 Too many requests (`rate_limited`). Wait for the number of seconds in `Retry-After`, which `retry_after_seconds` repeats.

```json
{
  "code": "rate_limited",
  "message": "Too many requests. Try again in 60 seconds.",
  "reason": "rate_limited",
  "retry_after_seconds": 60
}
```

## If it is refused

| Status | Reason | What to do |
|---|---|---|
| 401 |  | Send a valid token as `Authorization: Bearer <token>`. |
| 403 | `company_unavailable` | Your company is unavailable. |
| 403 | `scope_required` | Use a token with the scope named in `scope`. |
| 403 | `two_factor_required` | Turn on two-factor on your account, then send again. |
| 404 | `feature_off` | This feature is not on for your organisation yet. |
| 429 | `rate_limited` | Wait for the seconds in `Retry-After`. |

## The same task elsewhere

- Guide: [Change PHP version](https://docs.corefinity.com/guides/sites/software-and-services/php-version.md)
- MCP tool: [`corestack_runtime_get`](https://docs.corefinity.com/mcp/tools/corestack_runtime_get.md)
