Submissions API

{
  "formId": "vf-abc123",
  "submissionId": "vf-xyz789",
  "payload": {
    "encrypted": true,
    "version": "vf-e1",
    "data": "base64-encrypted-data...",
    "key": "base64-encrypted-aes-key...",
    "iv": "base64-initialization-vector..."
  },
  "timestamp": 1699920000000,
  "meta": {
    "sdk": "veilforms-js",
    "version": "1.0.0"
  }
}

{
  "success": true,
  "submissionId": "vf-xyz789",
  "timestamp": 1699920000000
}

curl "https://veilforms.com/api/submissions?formId=vf-abc123&limit=10" \
  -H "Authorization: Bearer vf_live_xxx"

{
  "formId": "vf-abc123",
  "submissions": [
    {
      "submissionId": "vf-xyz789",
      "payload": {
        "encrypted": true,
        "version": "vf-e1",
        "data": "base64...",
        "key": "base64...",
        "iv": "base64..."
      },
      "timestamp": 1699920000000,
      "receivedAt": 1699920001000,
      "meta": {
        "sdk": "veilforms-js",
        "version": "1.0.0"
      }
    }
  ],
  "total": 142,
  "limit": 10,
  "offset": 0
}

curl "https://veilforms.com/api/submissions/vf-xyz789?formId=vf-abc123" \
  -H "Authorization: Bearer vf_live_xxx"

{
  "submission": {
    "submissionId": "vf-xyz789",
    "payload": {
      "encrypted": true,
      "version": "vf-e1",
      "data": "base64...",
      "key": "base64...",
      "iv": "base64..."
    },
    "timestamp": 1699920000000,
    "receivedAt": 1699920001000
  }
}

curl -X DELETE "https://veilforms.com/api/submissions/vf-xyz789?formId=vf-abc123" \
  -H "Authorization: Bearer vf_live_xxx"

{
  "success": true,
  "deleted": "vf-xyz789"
}

import { decryptSubmission } from 'veilforms/core/encryption';

// Your private key (from localStorage or secure storage)
const privateKey = JSON.parse(localStorage.getItem('veilforms_private_keys'))['vf-abc123'];

// Encrypted submission from API
const encrypted = submission.payload;

// Decrypt in browser
const decrypted = await decryptSubmission(encrypted, privateKey);
console.log(decrypted);
// { name: "John", message: "Hello!" }

import { decryptSubmission } from 'veilforms/core/encryption';
import fs from 'fs';

// Load your private key from secure storage
const privateKey = JSON.parse(fs.readFileSync('./private-key.json'));

// Fetch submissions from API
const response = await fetch('https://veilforms.com/api/submissions?formId=vf-abc123', {
  headers: { 'Authorization': 'Bearer vf_live_xxx' }
});
const { submissions } = await response.json();

// Decrypt each submission
for (const sub of submissions) {
  const decrypted = await decryptSubmission(sub.payload, privateKey);
  console.log(sub.submissionId, decrypted);
}

curl "https://veilforms.com/api/submissions/export?formId=vf-abc123&format=json" \
  -H "Authorization: Bearer vf_live_xxx"

curl -X DELETE "https://veilforms.com/api/submissions?formId=vf-abc123&confirm=DELETE_ALL_SUBMISSIONS" \
  -H "Authorization: Bearer vf_live_xxx"

{
  "success": true,
  "deleted": 142
}