> ## Documentation Index > Fetch the complete documentation index at: https://docs.conversion.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Form > Get a tracked, published Conversion-native form by id, including the fields of its published definition. Each field's `fieldId` is the key used to reference the field in the forms JavaScript API and in submission data. Only tracked, published Conversion-native forms resolve; unknown ids, forms belonging to another workspace, external and ad forms, and untracked, archived, or never-published forms all return a `form_not_found` error. ## OpenAPI ````yaml /openapi.json get /v2/forms/{formId} openapi: 3.1.0 info: title: Conversion API version: 2.0.0 description: >- The Conversion API lets you programmatically manage contacts, track custom events, and manage their associated data. servers: - url: https://pub-api.conversion.ai/api security: - apiKey: [] paths: /v2/forms/{formId}: get: summary: Get Form description: >- Get a tracked, published Conversion-native form by id, including the fields of its published definition. Each field's `fieldId` is the key used to reference the field in the forms JavaScript API and in submission data. Only tracked, published Conversion-native forms resolve; unknown ids, forms belonging to another workspace, external and ad forms, and untracked, archived, or never-published forms all return a `form_not_found` error. operationId: getForm parameters: - name: formId in: path required: true schema: type: string format: uuid description: The Conversion form id, as returned by `GET /v2/forms`. examples: form: value: 9f3c1a2e-6b7d-4e2a-9c1f-1a2b3c4d5e6f responses: '200': description: Form retrieved successfully. content: application/json: schema: type: object properties: data: type: object required: - form properties: form: type: object required: - id - name - createdAt - updatedAt - submissionCount - lastSubmittedAt - fields properties: id: type: string format: uuid description: >- The Conversion form id. Use it as the `formId` path parameter of `GET /v2/forms/{formId}`. examples: - 9f3c1a2e-6b7d-4e2a-9c1f-1a2b3c4d5e6f name: type: string description: The form's display name. examples: - Demo Request createdAt: type: string format: date-time description: When the form was created. updatedAt: type: string format: date-time description: When the form was last updated. submissionCount: type: integer description: >- The total number of submissions received by the form. examples: - 412 lastSubmittedAt: type: - string - 'null' format: date-time description: >- When the form last received a submission, or `null` if it has never been submitted. fields: type: array description: >- The fields of the published form definition, including hidden fields. items: type: object required: - fieldId - name - type - required - hidden properties: fieldId: type: string description: >- The field's id in the form definition. Use this id to reference the field in the forms JavaScript API; submission data is keyed by it. examples: - aa8b2c1d-4e5f-4a6b-8c9d-0e1f2a3b4c5d name: type: string description: >- The field's name as configured in the form editor, unique within the form. It also labels the field's values in submission data. examples: - email type: type: string enum: - SHORT_ANSWER - LONG_ANSWER - DROPDOWN - NUMBER - EMAIL - PHONE_NUMBER - LINK - SINGLE_CHECKBOX - HIDDEN description: >- The field input type. `HIDDEN` fields are populated from the page rather than typed by the visitor. required: type: boolean description: >- Whether the field must be filled to submit. Always `false` for hidden fields. hidden: type: boolean description: Whether the field is a hidden field. examples: success: summary: A form with visible and hidden fields value: data: form: id: 9f3c1a2e-6b7d-4e2a-9c1f-1a2b3c4d5e6f name: Demo Request createdAt: '2026-05-01T12:00:00Z' updatedAt: '2026-06-11T09:30:00Z' submissionCount: 412 lastSubmittedAt: '2026-07-10T08:15:00Z' fields: - fieldId: aa8b2c1d-4e5f-4a6b-8c9d-0e1f2a3b4c5d name: email type: EMAIL required: true hidden: false - fieldId: bb9c3d2e-5f6a-4b7c-9d0e-1f2a3b4c5d6e name: company_size type: DROPDOWN required: false hidden: false - fieldId: cc0d4e3f-6a7b-4c8d-0e1f-2a3b4c5d6e7f name: message type: LONG_ANSWER required: false hidden: false - fieldId: dd1e5f4a-7b8c-4d9e-1f2a-3b4c5d6e7f8a name: utm_source type: HIDDEN required: false hidden: true '401': description: Authentication failed. content: application/json: schema: $ref: '#/components/schemas/Error' examples: unauthorized: summary: Missing or invalid API key value: error: code: unauthorized message: API key is required '404': description: The requested resource was not found. content: application/json: schema: $ref: '#/components/schemas/Error' examples: form-not-found: summary: Form not found value: error: code: form_not_found message: form not found '500': description: An unexpected server error occurred. content: application/json: schema: $ref: '#/components/schemas/Error' examples: internal: summary: Internal error value: error: code: internal_error message: failed to load form components: schemas: Error: type: object properties: error: type: object required: - code - message properties: code: type: string description: A machine-readable error code. examples: - invalid_email message: type: string description: A human-readable error description. examples: - 'invalid email format: not-an-email' securitySchemes: apiKey: type: apiKey in: header name: X-API-Key description: >- Your Conversion API key. Found in **Settings > Integrations** in the dashboard. Format: `sk_live__`. ````