Quickstart

A score in one call.

Authenticate with a scoped API key in the X-API-Key header and post the telemetry for one human-AI interaction. The response is synchronous and signed.

cURL# 1 · score one human-AI interaction $ curl -X POST api.cohesionauth.com/v1/score \ -H "X-API-Key: $COHESION_API_KEY" \ -H "Content-Type: application/json" \ -d '{"operator_id":"op_alice","session_id":"sess_42", "domain":"financial","interaction":{ ... }}' # 200 OK · signed evidence envelope { "jis": 82.4, "band": "proficient", "dimensions": 7, "article_14": "7/7" }
Two scoring paths

DRS routes the decision, JIS scores the router.

Use both together. The Decision Risk Score routes each AI-assisted decision; the Judgment Independence Score measures whether the reviewer is a trustworthy router.

POST /v1/decision/score

Submit one AI-assisted decision for Decision Risk Score routing. Returns the decision risk score, the routing decision, policy trigger evidence, and an audit identifier.

cURL# route one AI-assisted decision $ curl -X POST api.cohesionauth.com/v1/decision/score \ -H "X-API-Key: $COHESION_API_KEY" \ -d '{"operator_id":"analyst-0042","domain":"financial", "decision":"modified","modification_extent":0.31}' # 200 OK · routing recommendation { "decision_risk_score": 0.27, "routing_decision": "auto" }

POST /v1/score

Score the human-AI interaction telemetry and return the Judgment Independence envelope across the seven dimensions, the band, and the decay projection.

cURL# 1 · score one human-AI interaction $ curl -X POST api.cohesionauth.com/v1/score \ -H "X-API-Key: $COHESION_API_KEY" \ -H "Content-Type: application/json" \ -d '{"operator_id":"op_alice","session_id":"sess_42", "domain":"financial","interaction":{ ... }}' # 200 OK · signed evidence envelope { "jis": 82.4, "band": "proficient", "dimensions": 7, "article_14": "7/7" }
Built for compliance engineering

Designed to be cited, not just called.

Signed envelopes

Every response is a signed evidence envelope with a SHA-256 hash and an audit-chain entry, so a score can be verified later.

Signed receipt

API key authentication

Scoped API keys per environment, sent in the X-API-Key header. Rotate without downtime. Keys never appear in evidence receipts.

X-API-Key

Synchronous scoring

Scores return in band on the same request. No polling, no webhooks required for the common path.

Single round trip

Typed SDKs

First party clients for TypeScript and Python, generated from the same schema as the docs.

2 languages

Mapped to the spec

Each dimension in the response maps to a clause in the specification and a regulatory citation.

Spec v1.0

Observable

Latency and uptime are published. Incidents are posted to the status page with a timeline.

Live status
Reference

Selected endpoints.

A sample of the scoring API surface. The full reference, schema, and error catalog live in the docs.

POST /v1/decision/score Return a Decision Risk Score and a routing recommendation for one AI-assisted decision.
POST /v1/score Score one human-AI interaction and return the Judgment Independence envelope.
POST /v1/score/batch Score multiple interactions in a single signed request.
GET /v1/operator/{id}/profile Retrieve a reviewer's Judgment Independence Score band over time.
GET /v1/admin/audit/verify-chain Verify the signature and hash chain of the issued evidence receipts.
Full API reference

Get a key and score your first interaction.