RESTful API
Standard HTTP · JSON responses · Bearer auth
curl -X POST https://api.upstanding.com/v1/screen/initiate \
-H "Authorization: Bearer upst_live_sk_7f3a..." \
-H "Content-Type: application/json" \
-d '{
"candidate": {
"full_name": "Jane Doe",
"email": "jane@example.com",
"linkedin_url": "https://linkedin.com/in/janedoe"
},
"categories": [
"criminal_records",
"litigation_history",
"resume_fabrication",
"education_verification"
],
"webhook_url": "https://yourapp.com/hooks/screen",
"priority": "standard"
}'{
"id": "scr_9x8KmPqR4vTz",
"status": "processing",
"candidate_name": "Jane Doe",
"categories_requested": 4,
"estimated_completion": "2024-11-14T18:32:00Z",
"dashboard_url": "https://app.upstanding.com/report/scr_9x8KmPqR4vTz"
}Agentic MCP
Model Context Protocol · Tool registration · AI-native
{
"name": "upstanding_screen",
"description": "Initiate a background screening via Upstanding HR",
"inputSchema": {
"type": "object",
"properties": {
"full_name": {
"type": "string",
"description": "Candidate full legal name"
},
"categories": {
"type": "array",
"items": { "type": "string" },
"description": "Screening categories to run"
},
"priority": {
"type": "string",
"enum": ["standard", "expedited"],
"description": "Processing priority level"
}
},
"required": ["full_name", "categories"]
}
}Works with any MCP-compatible agent
Claude, GPT, Gemini, or your custom agent — register the Upstanding MCP server and your AI can autonomously initiate screens, retrieve reports, and act on verdicts.
Platform Capabilities
Everything you need to integrate
Six core primitives that cover the full screening lifecycle — from initiation to verdict delivery.
Programmatic Screening
Initiate full 12-category screens via a single POST. Receive structured JSON verdicts with confidence scores and source citations.
Real-time Webhooks
Subscribe to screening lifecycle events — initiated, category_complete, verdict_ready — delivered to your endpoint in < 200ms.
Batch Processing
Upload CSV manifests of up to 10,000 candidates. We parallelize across our screening cluster and stream results as they land.
Anonymous Flag API
Allow employees to submit anonymous workplace-concern flags programmatically, with end-to-end encryption and zero PII leakage.
Report Retrieval
Fetch completed screening reports in JSON, PDF, or DOCX. Filter by category, severity, or date range with granular query params.
Verdict Streaming
Open a Server-Sent Events stream and receive per-category verdicts the instant they clear — no polling, no waiting for the full report.
Rate Limits & Pricing
Scale when you're ready
Start free, upgrade as your integration grows. All tiers include full API access, webhooks, and MCP support.
Start building today.
Enter your email to generate a free API key. You'll be screening candidates in under five minutes.
No credit card required · 60 req/min free tier · SOC 2 compliant