API & MCP Integration

Build with Upstanding.

Programmatic access to the most comprehensive HR screening engine on the planet. RESTful endpoints, webhook events, and a native Model Context Protocol server for agentic AI workflows.

RESTful API

Standard HTTP · JSON responses · Bearer auth

initiate-screen.sh
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"
  }'
response.json
{
  "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

mcp-tool-registration.json
{
  "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.

TierRate LimitPrice
Developer
60 req / minFree
GrowthPopular
600 req / min$499 / mo
Enterprise
CustomContact Sales

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