Skip to content

get_submissions

Get form submissions for a deployment.

Annotations

AnnotationValue
readOnlyHinttrue
destructiveHintfalse
idempotentHintfalse
openWorldHinttrue

Parameters

NameTypeRequiredDescription
idstringYesThe deployment ID
pagenumberNoPage number (default: 1)
limitnumberNoResults per page (default: 50)

Return format

Returns the total count, current page, and a list of submissions:

Submissions for dep_abc123 (page 1, 127 total)

1. 2025-06-18T14:22:00Z
   email: alice@example.com
   name: Alice Johnson
   IP: 203.0.113.42

2. 2025-06-18T12:05:00Z
   email: bob@example.com
   name: Bob Smith
   IP: 198.51.100.7

...

Example

User prompt:

Show me all the signups from my waitlist and export them as CSV

What Claude does:

  1. Calls get_submissions with the deployment id.
  2. If there are more than 50 submissions, pages through the results by calling the tool again with page: 2, page: 3, etc.
  3. Formats all submissions as a CSV with columns for each form field.
  4. Presents the CSV to you for download or copying.

Notes

  • Each submission includes a created_at timestamp, the form data (key-value pairs matching your form field names), and the submitter's ip_address.
  • Pagination starts at page 1. If total exceeds page * limit, there are more pages to fetch.
  • The form data object keys match the name attributes of your HTML form fields. For example, <input name="email"> produces { "email": "..." }.
  • Submissions are returned in reverse chronological order (newest first).

Deploy forms and sites from AI conversations.