{"uid":"cap_n7SjvMn26_maQwxUrK-fV","slug":"agents-withzero-xyz-read-form-submissions-withzero-6ce0e3c8","name":"Read Form Submissions (WithZero)","description":"Read back the submissions to a form you created, newest first. Only the identity that created the form can read them. Paginate with limit (max 200) and the returned nextCursor.","url":"https://agents.withzero.xyz/api/v1/forms/forms/{id}/submissions?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"limit":{"type":"integer","description":"Page size, 1–200 (default 50)."},"cursor":{"type":"string","description":"The `nextCursor` from the previous page; omit for the newest submissions."}}},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["submissions","nextCursor"],"properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Pass as `cursor` to fetch the next (older) page; null when this is the last page."},"submissions":{"type":"array","items":{"type":"object","required":["id","createdAt","payload"],"properties":{"id":{"type":"string"},"payload":{"type":"object","description":"The submitted field values.","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string","description":"ISO 8601 timestamp."}},"additionalProperties":false}}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000000","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_ate2lNaoFsLKwqQQuwXzG","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000000","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.withzero.xyz","brandSlug":"agents-withzero-xyz-x402","brandBaseUrl":"https://agents.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Retrieves paginated form submissions for a form you created, ordered newest first, with cursor-based pagination.","exampleAgentPrompt":"Show me the latest 100 submissions to my form with ID abc123 — I want to see what people filled in.","exampleUseCases":[{"title":"Review survey responses newest first","prompt":"Pull up the most recent 50 responses to my feedback form with ID form_xyz — I want to see what people submitted this week."},{"title":"Page through large batch of form entries","prompt":"Get the next page of submissions for form form_456, picking up from cursor eyJpZCI6Mn0, and show me up to 200 entries."},{"title":"Export all contact form leads","prompt":"Retrieve all submissions from my contact form (ID contact_789) so I can see who reached out — start from the beginning and give me the newest 200 first."}],"resultDescription":"Returns a list of submission objects (each with an id, ISO 8601 createdAt timestamp, and a payload object containing the submitted field values), plus a nextCursor string (or null if no more pages) to use for fetching the next older page of results.","failureModes":["Form ID not found or does not belong to the calling identity — 404 or 403 error","Unauthenticated request — 401 error","limit out of range (must be 1–200) — 400 validation error","Invalid or expired cursor value — may return 400 or empty results","No submissions yet — returns empty submissions array with null nextCursor"],"whenToPreferThis":"Use this endpoint when you need to read back structured form submission data from a form you created via the WithZero platform. It is the correct choice when you need paginated, cursor-based access to submission records in reverse-chronological order. Prefer it over generic data storage lookups when the data was collected via a WithZero-hosted form.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T18:41:07.237Z","isFirstParty":true,"canonicalSlug":"agents-withzero-xyz-read-form-submissions-withzero-6ce0e3c8"}