---
title: "Get subscription form for environment"
method: GET
path: "/subscription-forms"
tags: ["Subscription Forms"]
---

# Get subscription form for environment

`GET /subscription-forms`

## Request

- Base URL: `/management/v2/environments/DEFAULT` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/management/v2/environments/DEFAULT/subscription-forms`
- Auth: one of:
  - HTTP basic
  - API key in cookie `Auth-Graviteeio-APIM`

Get the subscription form for the environment. Returns the form definition used
by API consumers when subscribing to APIs in the Developer Portal.

User must have the ENVIRONMENT_SETTINGS[READ] permission.

## Response `200`

Subscription form retrieved successfully

- SubscriptionForm: Subscription form definition used by API consumers when subscribing to APIs
  - `id` string, uuid, required: Unique identifier of the subscription form
  - `gmdContent` string, required: Gravitee Markdown (GMD) content defining the form. Supports form components like gmd-input, gmd-textarea, gmd-select, gmd-checkbox, gmd-radio.
  - `enabled` boolean, required: Whether the form is enabled and visible to API consumers in the Developer Portal
  - `resolvedOptions` object: Resolved option lists for fields that use EL expressions. Keys are field keys; values are the effective option lists (fallback values when no API context is available). Present only when at least one field has dynamic options.

## Other responses

- `404`: No subscription form exists for this environment
- `default`: Generic error response

## Changes

- **2026-04-03** `e308778b65d0`: 1 info
  - added the optional property `resolvedOptions` to the response with the `200` status
- **2026-02-17** `26283c0bd321`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/changes/subscription-forms/get.md)

---

[API](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments.md) - [All operations](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/llms.txt) - [OpenAPI document](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/revisions/b736a7e375df?raw)