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

# Get subscription form for environment

`GET /subscription-forms`

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

---

[API](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-environments.md) · [All operations](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-environments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gravitee-io/gravitee-io-apim-management-api-environments/versions/37e8cbe5f769/schema)