Rule Testing API

The Rule Testing API is a secure REST API that manage test runs.

Request authorization

To authenticate your requests, you must use a Bearer token with a valid Solver API key.

For example:

Authorization: Bearer YOUR_SOLVER_API_KEY

Start a Test Run

post

Starts a new test run job for the specified test suites or individual tests. You must provide either an array of testSuiteIds, an array of testIds, or both.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

x-correlation-idstringOptional

A custom correlation ID to track the job execution. If not provided, a GUID will be automatically generated.

Body

application/json

testSuiteIdsstring[]Optional

A list of Test Suite IDs to be executed.

testIdsstring[]Optional

A list of individual Test IDs to be executed.

Responses

200

The test run job has been successfully created and queued.

application/json

testRunIdstringOptional

The ID of the newly created test run job.

statusstring · enumOptional

Initial status of the test run job (e.g., WAITING).

Possible values:

400

Business error. Missing parameters or rule resolution failed.

401

Unauthorized. Invalid or missing API key.

post

/start

HTTPcURLJavaScriptPython

POST /testRun/start HTTP/1.1
Host: api.decisionrules.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "testSuiteIds": [
    "text"
  ],
  "testIds": [
    "text"
  ]
}

{
  "testRunId": "text",
  "status": "WAITING"
}

Get Test Run Job

get

Retrieves test run job details for a specific test run, including its overall execution state and timing context. The job must belong to the requesting space.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

testRunIdstringRequired

The ID of the test run job to retrieve details for.

Responses

200

Job details retrieved successfully.

application/json

jobIdstringOptional

correlationIdstringOptional

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

claimedAtstring · date-timeOptional

endedAtstring · date-time · nullableOptional

400

Business error.

401

Unauthorized. Invalid or missing API key.

get

/{testRunId}

HTTPcURLJavaScriptPython

GET /testRun/{testRunId} HTTP/1.1
Host: api.decisionrules.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "jobId": "text",
  "correlationId": "text",
  "inputData": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "output": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "status": {
    "state": "WAITING",
    "code": "text",
    "message": "text"
  },
  "createdAt": "2026-04-01T12:24:11.722Z",
  "updatedAt": "2026-04-01T12:24:11.722Z",
  "claimedAt": "2026-04-01T12:24:11.722Z",
  "endedAt": "2026-04-01T12:24:11.722Z"
}

Get Test Run Results Detail

get

Retrieves detailed information about a specific test run execution, including the evaluation status of individual tests and test suites.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

testRunIdstringRequired

The Test Run ID to retrieve results for.

Responses

200

Test run details retrieved successfully. Returns an array of evaluated rules, grouped by test suites and their nested test executions.

application/json

baseIdstringOptional

baseTypestring · enumOptionalPossible values:

statusstring · enumOptionalPossible values:

ruleNamestringOptional

ruleAliasstringOptional

ruleVersionnumberOptional

400

Business error.

401

Unauthorized. Invalid or missing API key.

get

/detail/{testRunId}

HTTPcURLJavaScriptPython

GET /testRun/detail/{testRunId} HTTP/1.1
Host: api.decisionrules.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "baseId": "text",
    "baseType": "decision-table",
    "status": "published",
    "ruleName": "text",
    "ruleAlias": "text",
    "ruleVersion": 1,
    "testSuiteRuns": [
      {
        "id": "text",
        "userId": "text",
        "spaceId": "text",
        "ruleAlias": "text",
        "ruleVersion": 1,
        "name": "text",
        "testSuiteId": "text",
        "status": "WAITING",
        "tests": [
          {
            "id": "text",
            "testId": "text",
            "name": "text",
            "strategy": "STANDARD",
            "input": null,
            "expectedOutput": null,
            "ignoredOutputs": [
              "text"
            ],
            "sortedInputHash": "text",
            "lastRunAt": "2026-04-01T12:24:11.722Z",
            "updatedAt": "2026-04-01T12:24:11.722Z",
            "resultStatus": "PASSED",
            "result": null,
            "error": null
          }
        ],
        "jobId": "text",
        "createdAt": "2026-04-01T12:24:11.722Z",
        "updatedAt": "2026-04-01T12:24:11.722Z",
        "claimedAt": "2026-04-01T12:24:11.722Z",
        "endedAt": "2026-04-01T12:24:11.722Z"
      }
    ]
  }
]