# forms.withzero.xyz - Read Form Submissions

> forms.withzero.xyz - Read Form Submissions is a paid API for AI agents from forms.withzero.xyz, paid per call via MPP, metered — billed by usage, status unknown (last checked 2026-10-23).

Retrieves paginated submissions for a hosted web form, ordered newest first, accessible only to the form creator.

## Facts

- Endpoint: GET https://forms.withzero.xyz/api/v1/forms/{id}/submissions?utm_source=zero.xyz
- Price: metered — billed by usage
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Provider: forms.withzero.xyz
- Website: https://forms.withzero.xyz
- Canonical page: https://www.zero.xyz/c/forms-withzero-xyz-read-form-submissions-19c90fa9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1pskqztd3erzjQffLQKdW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability forms-withzero-xyz-read-form-submissions-19c90fa9
```

Example prompt: Pull the 100 most recent submissions from my forms.withzero.xyz form with ID abc123 so I can see what people entered.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forms-withzero-xyz-read-form-submissions-19c90fa9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from forms.withzero.xyz](https://www.zero.xyz/host/forms.withzero.xyz/llms.txt)