Get Form Statistics is a WordPress ability from SureForms — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →Get Form Statistics
Read-onlyGet submission counts (total, unread, read, trash) for one form or across all forms.
Requires the SureForms plugin on WordPress 6.9+ (the Abilities API is gated behind function_exists('wp_register_ability'), so it degrades gracefully on WP 6.4-6.8). Abilities only register when the 'srfm_abilities_api' option is enabled in SureForms' AI settings, and every ability requires the current user to have the 'manage_options' capability. Abilities that create or modify data additionally require the 'srfm_abilities_api_edit' option to not be explicitly disabled; abilities that permanently delete data additionally require 'srfm_abilities_api_delete' to not be explicitly disabled.
What it does
This ability queries the SureForms entries table and returns total, unread, read, and trash entry counts, either scoped to a single form_id or aggregated across every form when form_id is 0 or omitted. When a specific form is requested, its title and status are validated and included in the response. It gives an AI assistant a quick pulse-check on form activity without pulling every individual entry.
See it in action
You ask your AI assistant
"How many unread submissions do I have across all my SureForms forms?"
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| form_id | integer | No | The ID of the form to get stats for. Use 0 or omit for all forms. Defaults to 0. |
Returns
An object with form_id, form_title, form_status, total_entries, unread_count, read_count, and trash_count.
Permission
Requires the 'manage_options' capability, and the 'srfm_abilities_api' master option must be enabled. This ability has no additional gate option.
More SureForms abilities
Bulk Get Entry Details
Retrieve full submitted data for up to 50 SureForms entries in a single call.
Create SureForms Form
Create a new SureForms form from a title, an array of field definitions, and optional metadata.
Delete Entry
Permanently delete one or more SureForms submission entries.
Delete SureForms Form
Move a SureForms form to trash, or permanently delete it when force is set.
Duplicate SureForms Form
Clone an existing SureForms form, including its fields, metadata, and settings, as a new draft.
Get Entry Details
Retrieve the full submitted data for a single SureForms entry, with field labels resolved.