---
title: "Get available environments"
method: GET
path: "/api/auth/environments"
tags: ["Authentication"]
---

# Get available environments

`GET /api/auth/environments`

## Request

- Base URL: `https://app.herondata.io`
- URL: `https://app.herondata.io/api/auth/environments`
- Auth: API key in header `x-api-key`

Get all available environments for the current user

## Response `200`

Ok

- AvailableEnvironments
  - `default_environment` string: Default environment for the user (username)
  - `organizations` AvailableEnvironmentsOrganization[]: List of organizations available to the user
    - `environments` AvailableEnvironmentsEnvironment[]: List of environments available to the user
      - `alias` string: Alias for the environment
      - `environment` string: Environment name
      - `username` string: Name of the environment
    - `name` string: Name of the organization
    - `slug` string: Slug of the organization

## Changes

- **2026-11-03** `bd8008e49534`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/herondata/apis/heron-data-api/changes/api/auth/environments/get.md)

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) - [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/herondata/apis/heron-data-api/revisions/1ec936e17fef?raw)
