How do I use Ninja Forms's Get Submissions ability with AI?

Install the Easy MCP AI WordPress plugin alongside Ninja Forms, connect your AI client, then ask in natural language — for example: "Get all submissions to form 12 where the Email field is john@example.com."

Get Submissions is a WordPress ability from Ninja Forms — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.

Install Free Plugin →

Get Submissions

Read-only

Ninja Forms Forms ninjaforms/get-submissions

Retrieve all submissions for a form, optionally filtered by field values or specific submission IDs.

Requires the Ninja Forms plugin on WordPress 6.9+ for the Abilities API (all 32 abilities are registered only when the wp_register_ability() function exists, via NF_Abilities_Integration::load_abilities_api() running on plugins_loaded). Every ability is gated by the same ninja_forms_ability_can_manage_forms() permission callback, requiring the caller to hold WordPress's manage_options capability or Ninja Forms' own nf_edit_forms capability.

What it does

This ability returns the submissions recorded against a form, optionally narrowed by a where object of field-key/value filters or a specific list of submission_ids. It's the lookup step an AI assistant uses to resolve a particular submission_id from a user's plain-language description ('the submission from John', 'today's entries') before drilling into ninjaforms/get-submission for full detail.

See it in action

You ask your AI assistant

"Get all submissions to form 12 where the Email field is john@example.com."

Inputs

Name	Type	Required	Description
form_id	integer	Yes	The numeric ID of the form.
where	object	No	Field key/value pairs to filter submissions by.
submission_ids	array	No	Specific submission IDs to retrieve.

Returns

An object with a 'success' boolean, the 'form_id', a 'count', a 'submissions' array, and a 'message'.

Permission

The current user must have WordPress's 'manage_options' capability or Ninja Forms' own 'nf_edit_forms' capability (checked via the shared ninja_forms_ability_can_manage_forms() permission callback).

More Ninja Forms abilities

Add Action

Add a post-submission action to a form — email, redirect, success message, or save.

Write

Add Calculation

Add a calculator formula to a form for use in calc fields and conditional logic.

Write

Add Field

Add a single field to an existing form, to be called once per field when building out a form.

Write

Create Form

Create a new Ninja Forms form, optionally with fields, actions, and calculations, in a single call.

Write

Delete Action

Permanently delete an action from a form.

Destructive

Delete Calculation

Permanently delete a calculation from a form.

Destructive