Skip to main content
POST
Rate a submission with a market rater version

Authorizations

Authorization
string
header
required

Effective API key. Send Authorization: Bearer sk-eai-...

Path Parameters

id
string
required

The market rater’s ID, such as effective.example-ca-ppa.

Pattern: ^[a-z0-9][a-z0-9._-]{0,127}$
version
integer
required

The published version number.

Required range: x > 0

Body

application/json
inputs
object
required

Response

Native rating result, timings and exact bundle identity.

programId
string
required

The market rater’s ID, such as effective.example-ca-ppa.

Pattern: ^[a-z0-9][a-z0-9._-]{0,127}$
version
integer
required
Required range: x > 0
raterId
string
required

The same value as programId.

bundleId
string
required

SHA-256 identity of the engine bundle that rated the submission.

Pattern: ^[a-f0-9]{64}$
programFingerprint
string
required

Fingerprint of the compiled rating program.

result
object
required

Outputs keyed by root record, for example {"Policy": {...}}. The version contract’s outputSchema describes it. The engine computes in exact decimals; the API returns them as JSON numbers with 64-bit float precision, about 15 significant digits.

timings
object
required

Milliseconds spent loading the engine (cold start only) and rating.

releaseVersion
integer

The same value as version.

Required range: x > 0