Developers ยท public API

Rating, reserving and GLM over HTTP

Every calculation in Decision Studio is available as JSON. Rating deploys only approved or locked models from the governance workflow, so what your policy admin system quotes is exactly what a reviewer signed off. Send Authorization: Bearer ak_live_โ€ฆ.

API keys

Sign in to create keys.

Endpoints

POST /api/public/v1/rate

Hosted rating. Quote a premium from an approved or locked GLM-studio analysis (governed deployment), or from an inline base rate and relativity tables. Send `risk` for one quote or `risks[]` (โ‰ค500) for batch quoting; each response itemises every relativity applied.

curl -X POST https://<your-actuarium-domain>/api/public/v1/rate \
  -H "Authorization: Bearer $ACTUARIUM_KEY" -H "Content-Type: application/json" \
  -d '{
  "analysisId": "<saved GLM-studio analysis id, status approved/locked>",
  "risk": { "age_band": "25-34", "vehicle_group": "C", "years_licensed": 6 },
  "exposure": 0.5,
  "expenseLoad": 0.28
}'
GET /api/public/v1/rate-table?analysisId=<id>&format=guidewire

Export the model's rating table as JSON or CSV in Guidewire, Duck Creek, Majesco or generic layouts, with the governed model version in x-actuarium-model-version. Push-based deployments (signed webhooks) are configured below.

curl "https://<your-actuarium-domain>/api/public/v1/rate-table?analysisId=<id>&format=guidewire" -H "Authorization: Bearer $ACTUARIUM_KEY" -o rate-table.csv
POST /api/public/v1/reserve

Chain-ladder ultimates, Mack standard errors and machine-led method selection (CL variants, BF, Benktander, Cape Cod) with hindsight weights.

curl -X POST https://<your-actuarium-domain>/api/public/v1/reserve \
  -H "Authorization: Bearer $ACTUARIUM_KEY" -H "Content-Type: application/json" \
  -d '{
  "triangle": [[1000, 1800, 2100, 2200], [1100, 1950, 2300, null], [1300, 2200, null, null], [1250, null, null, null]],
  "premium": [3000, 3200, 3400, 3500],
  "tail": 1.02
}'
POST /api/public/v1/glm

Fit a Poisson/Gamma/Tweedie/Gaussian/Binomial GLM on delimited data; returns coefficients, relativities, deviance, AIC, Gini.

curl -X POST https://<your-actuarium-domain>/api/public/v1/glm \
  -H "Authorization: Bearer $ACTUARIUM_KEY" -H "Content-Type: application/json" \
  -d '{
  "csv": "claims,exposure,age_band,vehicle_group\n2,1.0,25-34,C\n0,0.5,35-44,A\n...",
  "response": "claims", "family": "poisson", "exposure": "exposure",
  "predictors": ["age_band", "vehicle_group"], "categorical": ["age_band", "vehicle_group"]
}'
Errors return { error } with 400 (validation), 401 (key), 404 (analysis), 409 (model not approved) or 422 (fit failed). Responses are CORS-enabled. Keys are stored as SHA-256 hashes; revoke and re-issue at any time.
Ask the tutor