REST API v1.0 REAL-TIME WEBHOOKS HMAC SHA-256 SIGNED

Enterprise API & Survey Operations Integration

Connect your research platform, survey programming engine, or sample network directly into Scrutiny Global. Execute automated feasibility calculations, query live project quotas, ingest study specs, and receive signed outcome callbacks with microsecond latency.

Request API Access Client Guide (PDF) Vendor Guide (PDF)

DOCUMENTATION VAULT

Official Integration Guides (2026 Edition)

Updated: May 2026 • PDF Specification v1.0

CLIENT EDITION 13 Pages

Client API Integration Guide

For enterprise research buyers, agencies, and brands. Complete reference for project specs, quota tracking, feasibility calculation, and data access.

VENDOR EDITION 12 Pages

Vendor API Integration Guide

For panel suppliers, sample routers, and survey exchanges. Specifications for survey import, quota sync, HMAC signatures, and webhook callbacks.

AUDIENCE DIRECTORY 2026 Master

2026 Global Panel Book

Complete demographic matrix, country-by-country reach, B2B decision-maker profiles, and clinical healthcare specialties across 70+ markets.

COMPLIANCE ESOMAR 37

ESOMAR 37 Disclosure

Full institutional transparency disclosure answers for sample buyers under the ESOMAR 37 standard, covering recruitment, validation & quality.

AUTHENTICATION & SCOPES

Client API Architecture

Client API keys are scoped to your organization account and provide programmatic access to feasibility calculation, active survey specifications, live quota fulfillment cells, and anonymized respondent research metadata.

projects.read

Query project specifications, quota cell status, and 24-hour activity logs.

feasibility.calculate

Calculate real-time incidence, feasible completes, EPC, and delivery timelines.

respondents.read

Inspect anonymized demographic respondent profile attributes (PII stripped).

analytics.read

Access account-wide conversion, incidence rates, and field velocity metrics.

# Pass your API Key in the X-API-KEY request header
GET /api/v1/projects HTTP/1.1
Host: survey.scrutinyglobal.com
X-API-KEY: sg_live_your_client_key
Accept: application/json

ENDPOINTS REFERENCE

Core Client REST Endpoints

Method & Path	Scope	Purpose
GET /api/v1/health	Public	Check database, cache, and platform operational readiness.
POST /api/v1/feasibility	feasibility.calculate	Calculate dynamic reach, estimated completes, and feasibility score.
GET /api/v1/projects	projects.read	List active, paused, or completed survey projects with pagination.
GET /api/v1/projects/{id}	projects.read	Retrieve demographic quota cell breakdown & real-time fulfillment numbers.
GET /api/v1/projects/{id}/activity	projects.read	Query 24-hour activity counts (completes, terminates, over-quotas).
GET /api/v1/respondents/{id}	respondents.read	Access anonymized respondent profile (gender, country, quality rating).

CODE EXAMPLES

Calculate Feasibility Example (Python)

import requests

url = "https://survey.scrutinyglobal.com/public/admin/api/v1/feasibility"
headers = {
    "X-API-KEY": "sg_live_your_client_key",
    "Content-Type": "application/json"
}
payload = {
    "country": "US",
    "age_min": 25,
    "age_max": 54,
    "gender": "All",
    "incidence_rate": 60,
    "target_completes": 300
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

SUPPLY & EXCHANGE ARCHITECTURE

Vendor Sample Exchange & Webhooks

The Vendor API enables panel supply partners (e.g. Cint, Lucid, Dynata, PureSpectrum) to import survey specifications, synchronize quota cells in real time, reconcile completions, and receive cryptographically signed outcome webhooks.

assignments.read

Query vendor-assigned project inventory and health status.

vendor.manage

Import external studies, trigger quota synchronization, and reconcile ledgers.

respondents.submit

Submit respondent outcomes and handle bi-directional webhook callbacks.

# HMAC SHA-256 Signature Canonicalization Formula
Signature = HMAC-SHA256( timestamp . METHOD . path . body_hash . api_key , api_secret )

SUPPLY ENDPOINTS REFERENCE

Core Vendor REST & Webhook Endpoints

Method & Path	Scope	Purpose
GET /api/v1/vendor/projects	assignments.read	Retrieve survey studies assigned to your supply gateway.
POST /api/v1/vendor/import-survey	vendor.manage	Programmatically import a new study specification into Scrutiny Global.
POST /api/v1/vendor/sync-quotas	vendor.manage	Trigger real-time quota refreshes and inventory synchronization.
POST /api/v1/vendor/reconcile	vendor.manage	Submit reconciled completion and termination totals for billing settlement.
POST /api/v1/webhooks/{provider}	HMAC Signature	Inbound real-time webhook callback receiver (lucid, cint, dynata, purespectrum).

HMAC IMPLEMENTATION

HMAC-SHA256 Signing in Node.js

Request API Credentials

Submit your technical organization profile to receive Sandbox API keys, webhook test endpoints, and integration support within 4 business hours.