---
title: "Changes to Get a form definition"
method: GET
path: "/marketing/forms/2026-09-beta/{formId}"
---

# Changes to Get a form definition

`GET /marketing/forms/2026-09-beta/{formId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 55 revisions.

- **2026-08-17** (2026-09-beta) `12cd90f1eb18` — 1 info
- **2026-07-13** (2026-09-beta) `0a2f094f9ab4` — 1 breaking
- **2026-05-22** (2026-09-beta) `36245144443e` — 3 info
- **2026-05-14** (2026-09-beta) `b74d391e3e83` — 10 info
- **2026-05-13** (2026-09-beta) `db0d2eb4691d` — 1 breaking, 12 info
- **2026-05-04** (2026-09-beta) `78d0073d1637` — 1 info

## Changes

- **2026-08-17** (2026-09-beta) `12cd90f1eb18` — 1 info
  - endpoint added
- **2026-07-13** (2026-09-beta) `0a2f094f9ab4` — 1 breaking
  - api path removed without deprecation
- **2026-05-22** (2026-09-beta) `36245144443e` — 3 info
  - the security scope `forms` was added to the endpoint's security scheme `oauth2`
  - the security scope `forms-access` was removed from the endpoint's security scheme `oauth2`
  - the security scope `forms-read` was removed from the endpoint's security scheme `oauth2`
- **2026-05-14** (2026-09-beta) `b74d391e3e83` — 10 info
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/archived` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/configuration` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/createdAt` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/displayOptions` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/fieldGroups` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/formType` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/id` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/legalConsentOptions` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/name` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/updatedAt` became required for the status `200`
- **2026-05-13** (2026-09-beta) `db0d2eb4691d` — 1 breaking, 12 info
  - the `oneOf[#/components/schemas/HubSpotFormDefinition]/` response's property type changed from no type to `object` for status `200`
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/archived` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/archivedAt` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/configuration` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/createdAt` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/displayOptions` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/fieldGroups` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/formType` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/id` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/legalConsentOptions` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/name` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/updatedAt` to the response with the `200` status
  - removed `#/components/schemas/FormDefinitionBase, subschema #2` from the `oneOf[#/components/schemas/HubSpotFormDefinition]/` response property `allOf` list for the response status `200`
- **2026-05-04** (2026-09-beta) `78d0073d1637` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/hubspot/apis/marketing-forms/docs/marketing/forms/2026-09-beta/:formId/get.md) · [API](https://skmtc.dev/hubspot/apis/marketing-forms.md) · [Page](https://skmtc.dev/hubspot/apis/marketing-forms/changes/marketing/forms/2026-09-beta/:formId/get)