API Reference

Partner Access Model

The ValidKernel API is not publicly self-serve. Access is granted through controlled partner agreements to ensure deterministic stability and governed integration.

To evaluate integration with your environment, request partner access through our engineering team.

Base URL is provisioned per-partner upon access approval.

https://api.validkernel.com/v1  (partner-provisioned)

Authorization: Bearer vk_partner_xxxxxxxxxxxxxxxxxxxx

Check system health status. Available to all authenticated partners.

Response

{
  "status": "healthy",
  "version": "1.0.0",
  "latency_ms": 0.008,
  "policies_loaded": 1,
  "uptime_seconds": 86400
}

Validate a request against loaded policies. Core endpoint for trust enforcement.

Request Body

{
  "request_id": "req_abc123",
  "policy": "default",
  "input": {
    "data": "...",
    "metadata": {}
  },
  "context": {
    "user_id": "user_123",
    "source": "api"
  }
}

Response

{
  "status": "EXECUTE",
  "request_id": "req_abc123",
  "audit_id": "aud_xyz789",
  "latency_ms": 0.009,
  "policy_version": "v1.2.0",
  "timestamp": "2026-01-17T12:00:00Z"
}

Status Values

Submit a governed query through the Mirror surface. Returns a trust-scoped response without exposing internal structure.

Request Body

{
  "query": "What materials are required for ...",
  "scope": "public",
  "session_id": "optional_session_id"
}

Response

{
  "response": "...",
  "query_id": "mq_abc123",
  "scope": "public",
  "trust_level": "governed",
  "timestamp": "2026-01-17T12:00:00Z"
}

Retrieve audit logs. Restricted to partners with admin-level access authorization.

Query Parameters