List Form Submissions | Pinnacle

import { PinnacleClient } from "rcs-js";
async function main() {
    const client = new PinnacleClient({
        apiKey: "YOUR_API_KEY_HERE",
    });
    await client.forms.submissions.list("form_Oy2n7iUoi9CJwUU6", {
        pageIndex: 0,
        pageSize: 20,
    });
}
main();

{
  "data": [
    {
      "id": "fsub_T17R9JjWSCnc2MDQ",
      "url": "https://forms.pinnacle.sh/fsub_T17R9JjWSCnc2MDQ",
      "form_id": "form_Oy2n7iUoi9CJwUU6",
      "from": "agent_iM9wQcyBBjYn",
      "to": "+14155551234",
      "data": {
        "full_name": "Ada Lovelace",
        "email": "ada@example.com",
        "plan": "pro"
      },
      "ip_address": "203.0.113.45",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_5) AppleWebKit/605.1.15",
      "submitted_at": "2026-04-23T22:15:04.406Z",
      "created_at": "2026-04-23T22:10:00.000Z"
    }
  ],
  "hasMore": false,
  "count": 1
}

Paginated list of completed submissions for a form, newest first. Each row includes the submitted data keyed by field key, the sender/recipient, IP, user-agent, and timestamps.

Authentication

PINNACLE-API-KEYstring

API Key authentication via header

Path parameters

idstringRequired

The unique identifier of the form whose submissions you want to list.

This identifier is a string that always begins with the prefix form_, for example: form_Oy2n7iUoi9CJwUU6.

Request

This endpoint expects an object.

pageIndexintegerOptional>=0Defaults to 0

Zero-based page index.

pageSizeintegerOptional1-100Defaults to 20

Number of submissions to return in a single page. Max 100.

Response

Paginated list of submissions.

datalist of objects

Submissions on this page, newest first.

hasMoreboolean

True if there are more pages after this one. Fetch the next page by incrementing pageIndex.

countinteger

Number of submissions returned in data.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error