{"uid":"cap_1pskqztd3erzjQffLQKdW","slug":"forms-withzero-xyz-read-form-submissions-19c90fa9","name":"forms.withzero.xyz - Read Form Submissions","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://forms.withzero.xyz/api/v1/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","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unprobed","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":"metered","summary":"metered — billed by usage","primary":{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm__PAFodxDS5Z_IRPxeQD5x","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"forms.submissions.list:1"}],"brandName":"forms.withzero.xyz","brandSlug":"forms-withzero-xyz-mpp","brandBaseUrl":"https://forms.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Retrieves paginated submissions for a hosted web form, ordered newest first, accessible only to the form creator.","exampleAgentPrompt":"Pull the 100 most recent submissions from my forms.withzero.xyz form with ID abc123 so I can see what people entered.","exampleUseCases":[{"title":"Lead capture review for sales team","prompt":"Show me the latest 50 submissions from my contact form (ID: form_lead_abc) on forms.withzero.xyz so I can follow up with new leads."},{"title":"Event registration tally","prompt":"Fetch all submissions to my event sign-up form (ID: evt_xyz789) — I want to see who registered, starting from the newest entries, 200 at a time."},{"title":"Survey results export","prompt":"Get the next page of survey responses from my forms.withzero.xyz form ID survey_q1_2024 using cursor eyJpZCI6MTIz so I can continue processing where I left off."}],"resultDescription":"Returns an array 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) for paginating to older submissions.","failureModes":["Form ID not found — 404 if the form does not exist or does not belong to the calling identity","Unauthorized — 401/403 if the caller is not the identity that created the form","Invalid cursor — 400 if the cursor value is malformed or expired","Invalid limit — 400 if limit is outside the 1–200 range","Empty submissions array with null nextCursor — form exists but has no submissions yet"],"whenToPreferThis":"Use this endpoint when you need to read back user-submitted data from a hosted form created via forms.withzero.xyz. It is the only way to retrieve submission payloads for those forms, and supports cursor-based pagination for large submission volumes. Prefer this over polling email notifications when you need structured, programmatic access to responses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T00:47:32.853Z","isFirstParty":true,"canonicalSlug":"forms-withzero-xyz-read-form-submissions-19c90fa9"}