---
title: "List environment capabilities and state contracts"
method: GET
path: "/api/environments"
---

# List environment capabilities and state contracts

`GET /api/environments`

## Response `200`

Successful response

- object
  - `schema` 'archal.environment-catalog', required
  - `version` integer, required
  - `environments` object[], required
    - `id` string, required
    - `name` string, required
    - `availability` 'available' | 'in-progress', required
    - `startable` boolean, required
    - `launch` boolean, required
    - `transports` string[], required
    - `certification` object, required
      - `status` 'healthy' | 'degraded' | 'quarantined' | 'unknown', required
      - `admission` 'allow' | 'warn' | 'deny', required
      - `checkedAt` string, date-time, nullable, required
      - `evidenceSha256` string, nullable, required
    - `state` object, required
      - `readable` boolean, required
      - `writable` boolean, required
      - `resettable` boolean, required
      - `formats` string[], required
      - `contract` object, nullable, required

## Other responses

- `400` — The request was rejected
- `401` — The request was rejected
- `403` — The request was rejected
- `404` — The request was rejected
- `409` — The request was rejected
- `413` — The request was rejected
- `429` — The request was rejected
- `500` — The request was rejected
- `502` — The request was rejected
- `503` — The request was rejected

---

[API](https://skmtc.dev/archal/apis/archal-api.md) · [All operations](https://skmtc.dev/archal/apis/archal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/archal/archal-api/revisions/a06cd479cc93/schema)