# Read Form Submissions (WithZero)

> Read Form Submissions (WithZero) is a paid API for AI agents from agents.withzero.xyz, paid per call via MPP, price unknown, status unknown (last checked 2026-11-17).

Retrieves paginated form submissions for a form you created, ordered newest first, with cursor-based pagination.

## Facts

- Endpoint: GET https://agents.withzero.xyz/api/v1/forms/forms/{id}/submissions?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Provider: agents.withzero.xyz
- Website: https://agents.withzero.xyz
- Canonical page: https://www.zero.xyz/c/agents-withzero-xyz-read-form-submissions-withzero-6ce0e3c8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n7SjvMn26_maQwxUrK-fV

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 agents-withzero-xyz-read-form-submissions-withzero-6ce0e3c8
```

Example prompt: Show me the latest 100 submissions to my form with ID abc123 — I want to see what people filled in.

## When to prefer this

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.

## Known failure modes

- 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

## 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 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.

## 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/agents-withzero-xyz-read-form-submissions-withzero-6ce0e3c8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.withzero.xyz](https://www.zero.xyz/host/agents.withzero.xyz/llms.txt)
