🧪 Form Submission API Test Examples

1. Get Latest Form Submissions

Retrieve the most recent form submissions for your project.

2. Search by Email

Find all form submissions with a specific email address.

3. Get Session Submissions

Get all form submissions from a specific recording session.

4. Get Form Statistics

View statistics about form submissions in your project.

5. Get Common Form Fields

Discover the most common form fields across all submissions.

6. Filter by Status

Get form submissions filtered by their processing status.

JavaScript/Node.js Example

// Fetch latest form submissions
async function getFormSubmissions(projectId, apiKey) {
    const response = await fetch(`${API_URL}/api/projects/${projectId}/form-submissions`, {
        headers: {
            'X-API-Key': apiKey,
            'Content-Type': 'application/json'
        }
    });
    
    const data = await response.json();
    return data.submissions;
}

// Search by email
async function searchByEmail(projectId, apiKey, email) {
    const params = new URLSearchParams({
        fieldName: 'email',
        fieldValue: email,
        limit: '50'
    });
    
    const response = await fetch(
        `${API_URL}/api/projects/${projectId}/form-submissions?${params}`,
        {
            headers: {
                'X-API-Key': apiKey
            }
        }
    );
    
    return await response.json();
}
            

cURL Example

# Get form submissions
curl -X GET "https://api.validiform.com/api/projects/YOUR_PROJECT_ID/form-submissions" \
     -H "X-API-Key: YOUR_API_KEY"

# Search by email
curl -X GET "https://api.validiform.com/api/projects/YOUR_PROJECT_ID/form-submissions?fieldName=email&fieldValue=user@example.com" \
     -H "X-API-Key: YOUR_API_KEY"

# Get statistics
curl -X GET "https://api.validiform.com/api/projects/YOUR_PROJECT_ID/form-submissions/stats" \
     -H "X-API-Key: YOUR_API_KEY"