Calculate attributes

Calculate selected attributes from a frozen evidence window.

Required scope: risk:calculate. GET /v1/attribute-calculations/ reports job state; values in /v1/attributes. Once account cancellation is submitted, processing and usage deductions stop immediately. Reject new operational commands with 409 invalid_state; pending work is cancelled without another debit. Read-only reporting remains available until workspace deletion. Discover input_manifest_id through GET /v1/input-manifests. It must be ready and belong to the same subject and workspace. The calculation window must be contained within its frozen coverage. This is a stage of an authorized Insights or Signal workflow. processing_context is required; unrelated, completed, unpaid, cancelled or unentitled contexts return 409 invalid_state. It creates no separate AMLOK charge. The orchestrator deduplicates equivalent stage work within the parent. Accepted commands have a durable request receipt. Full response replay lasts 24 hours; afterward the same key and target return 409 idempotency_result_expired without re-execution. Different payloads return 409 idempotency_conflict. Use GET /v1/request-receipts/lookup to find the original resource. The fingerprint includes the resolved target path and intended payload; a key used on another target is rejected rather than replayed onto it. Pre-execution validation or insufficient-credit rejection creates no accepted receipt.

POST /v1/attribute-calculations

cURL

cURL

curl --request POST --fail-with-body --max-time 30 \
  "${AMLOK_API_BASE_URL}/v1/attribute-calculations" \
  --header "Authorization: Bearer ${AMLOK_API_KEY}" \
  --header "Accept: application/json" \
  --header 'Idempotency-Key: idem_example_1001' \
  --header 'Content-Type: application/json' \
  --data '{
  "subject_id": "biz_example",
  "keys": [
    "operating_inflows"
  ],
  "window_start": "2026-09-01",
  "window_end": "2026-10-01",
  "input_manifest_id": "manifest_example",
  "processing_context": {
    "product": "insights",
    "workflow_run_id": "wfr_example"
  }
}'

202

synthetic

{
  "data": {
    "id": "calc_example",
    "status": "queued",
    "subject_id": "biz_example",
    "attribute_ids": [],
    "errors": [],
    "stop_reason": null,
    "processing_context": {
      "product": "insights",
      "workflow_run_id": "wfr_example"
    }
  },
  "meta": {
    "request_id": "req_example",
    "schema_version": "1.4.2",
    "generated_at": "2026-10-23T14:00:00Z",
    "data_status": "pending"
  }
}

Required scope: risk:calculate

Calculate selected attributes from a frozen evidence window.

Required scope: risk:calculate. GET /v1/attribute-calculations/ reports job state; values in /v1/attributes. Once account cancellation is submitted, processing and usage deductions stop immediately. Reject new operational commands with 409 invalid_state; pending work is cancelled without another debit. Read-only reporting remains available until workspace deletion. Discover input_manifest_id through GET /v1/input-manifests. It must be ready and belong to the same subject and workspace. The calculation window must be contained within its frozen coverage. This is a stage of an authorized Insights or Signal workflow. processing_context is required; unrelated, completed, unpaid, cancelled or unentitled contexts return 409 invalid_state. It creates no separate AMLOK charge. The orchestrator deduplicates equivalent stage work within the parent. Accepted commands have a durable request receipt. Full response replay lasts 24 hours; afterward the same key and target return 409 idempotency_result_expired without re-execution. Different payloads return 409 idempotency_conflict. Use GET /v1/request-receipts/lookup to find the original resource. The fingerprint includes the resolved target path and intended payload; a key used on another target is rejected rather than replayed onto it. Pre-execution validation or insufficient-credit rejection creates no accepted receipt.

Product scope · Processing lifecycle · Errors

Authorizations

Authorization · string · header · required

Server-to-server API key bound to exactly one workspace, institution tenant and environment. No caller-supplied workspace override is accepted. Do not use in public browser code.

Headers

X-Request-ID · string

Optional caller correlation ID; the response includes AMLOK request_id.

Idempotency-Key · string · required

Reuse for retries of the same intended command and identical payload. Retention: 24 hours.

Body

application/json

processing_context · object · required

Parent must belong to this workspace. Same-subject stages need no association. Only person KYC may target a different subject: supply an active subject_association_id linking that person to the parent business. Insights requires an unfinished authorized root run; Signal requires an active paid period. Stage scope, consent, association and workload are checked on every attempt. The parent business remains the billing and workload subject. No standalone service or extra charge.

Option 1

Option 2

Show child attributes

subject_id · string · required

Subject being assessed.

Minimum string length: 1

keys · string[] · required

Requested attribute names.

Minimum array length: 1

window_start · string<date> · required

Inclusive interval start.

window_end · string<date> · required

Exclusive interval end.

input_manifest_id · string · required

Immutable authorized evidence manifest.

Minimum string length: 1

Response

202

application/json

Calculate selected attributes from a frozen evidence window. Accepted work is not yet complete.

data · object · required

Show child attributes

meta · object · required

Show child attributes