# Run Decision Tree

Runs the provided decision tree for the given company, optionally using the data provided in the body of the call.

Endpoint: POST /decisionEngine/{provenirId}
Version: 1.0.0
Security: bearerToken

## Path parameters:

  - `provenirId` (string, required)
    The unique identifier of the decision tree to run, obtained from .

## Query parameters:

  - `companyId` (string, required)
    The Connect ID for the company that you wish to run the decision tree on. Obtained from  search results. A Connect ID is the primary Company identifier that is used to uniquely identify all companies across Creditsafe's Universe and Partner Network.
    Example: "GB-0-03836192"

  - `originationId` (string)
    An optional field that will allow text passed through to be stored against the decision. Typically used for internal identifiers (e.g. SalesForce IDs).
    Example: "SFC-1976"

## Response 200 fields (application/json):

  - `Decision` (string,null)
    The decision returned by the automated decision model.
    Example: "Reject"

  - `DecisionText` (string,null)
    The text output to accompany the decision returned by the decision model.
    Example: "The Sales Value requested is greater than Creditsafe's recommended credit limit."

  - `Audits` (array,null)
    An array of audit values. The parameters output for audit are tailored and bespoke to each decision tree.

  - `Audits.description` (string,null)
    The value for the audit parameter at the point in time in which the decision tree was run.
    Example: "A"

  - `Audits.RuleName` (string,null)
    The friendly name for the audit parameter.
    Example: "International Score"

  - `originationId` (string,null)
    Displays the optional text passed through to be stored against the decision in the original call to . Typically used for internal identifiers (e.g. SalesForce IDs).
    Example: "SFC-1976"

  - `statusCode` (string,null)
    The status of the decision. typically, 1 is reserved for positive outcomes, 2 for pending status and 3 for negative outcomes.
    Example: "3"

## Response 400 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 401 fields (application/json):

  - `error` (string)