Docs
Partner quick start
Five steps from invite to your first score. Access is by invitation only.
1. Get access
Staff invite partners. Access is never self-serve. Request a pilot and the team will follow up.
2. Receive a key
Staff mint your key with POST /api/v1/keys. It starts with drk_. The plaintext is shown once, so store it safely. Send it as Authorization: Bearer <key> or X-API-Key: <key>.
3. Send your first score
Every input field is optional. Select the request to copy it.
curl -X POST https://drice.wentzel.ai/api/v1/score \
-H "Authorization: Bearer drk_<your-key>" \
-H "Content-Type: application/json" \
-d '{"edr_coverage":0.8,"mfa_adoption":0.9,"patch_cadence_days":14,"industry":"retail"}'4. Read the response
A valid request returns 200 with a report. Read actuarial_risk_score (300 to 850) and confidence_level first. Then check key_strengths and key_weaknesses. Keep report_id to fetch the report later with GET /api/v1/score/[id]. A bad body returns 400 validation_failed in an application/problem+json body. Read code, title, and status; validation errors contain field pointer and detail values.
5. Handle 429
A rate-limited call returns 429 rate_limited with a Retry-After header in seconds. Wait that long, then retry. A 503 rate_limit_unavailable carries the same header.
Get help
See the API overview for every field and error, or contact support.