Credits
BetaRisk API v2 bills in credits. Your contract sets the dollar rate; this page documents the credit units the API charges.
Beta
Overview
Every POST /v2/risk job charges a core amount plus any priced modules included in the request. Snapshot extend charges only the one module you add.
Credits are organization-wide. All API keys for an organization share the same balance.
We do not publish dollar rates here. Your Relativity6 agreement sets the price per credit.
What a job costs
A job always includes the core assessment. Selected modules add their weights. Duplicate module ids are charged once.
| Item | Credits |
|---|---|
Core assessmentCharged on every POST /v2/risk job. | 12 |
| Digital riskdigital_risk | 4 |
| Adverse newsadverse_news | 3 |
| Property financialsproperty_financials | 5 |
| Form 5500form_5500 | 2 |
| IRS Form 990irs_990 | 2 |
| Business risk flagsbusiness_risk_flags | 4 |
| FMCSA / SAFERfmcsa_safer | 2 |
| OSHAosha | 2 |
| Producer reportproducer_report | 2 |
Restricted-list screening and liquor licenses are currently 0 credits (limited availability). Trade licenses are not returned and are not billed.
Example
A plan: "core" job costs 12 credits. Adding OSHA (osha) and Form 5500 (form_5500) on the same submit adds those module weights to the core charge.
When credits are charged
| Action | When charged | If it fails |
|---|---|---|
POST /v2/risk | When the job is accepted (202) | Refunded if the job fails or you cancel it before a result is stored |
POST /v2/snapshots/{id}/extend | When the extend starts | Refunded if the extend fails or returns degraded |
Retry with Idempotency-Key | Not charged again | Reuses the original job |
Successful completions keep the charge. Polling, listing webhooks, and reading a completed job do not consume credits.
Insufficient credits
If the organization does not have enough credits, POST /v2/risk and snapshot extend return HTTP 402 with:
| Field | Meaning |
|---|---|
code | Always INSUFFICIENT_CREDITS |
credits_needed | Credits this request would have charged |
remaining_credits | Current remaining balance |
No job is created when submit returns 402.
Overages
If your organization is configured to allow overages, a request can complete even when the remaining balance is below the charge. The used balance may then exceed the contracted total. Organizations without overages receive 402 instead.