Skip to main content
POST
/
v1
/
loans
/
{applicationId}
/
start-decisioning
Start Decisioning
curl --request POST \
  --url https://carbonapistagingsecure.getcarbon.co/baas/api/v1/loans/{applicationId}/start-decisioning \
  --header 'apikey: <api-key>' \
  --header 'x-carbon-key: <x-carbon-key>'
{
  "status": "success",
  "message": "Decisioning started"
}

​
Overview

Triggers the credit decision engine (Taktile) to evaluate the application. Call this after underwriting data and bank statement have been submitted. In some environments this fires automatically; call it manually if status stays PENDING after underwriting.

​
Request

Method: POST
URL: /v1/loans/:applicationId/start-decisioning

​
Parameters

NameInTypeRequiredDescription
x-carbon-keyHeaderstringYesAPI key for authentication.
applicationIdPathstringYesApplication ID.
No request body required.

​
Response

​
200 OK

{
  "status": "success",
  "message": "Decisioning started",
  "data": {}
}

​
Error Responses

StatusMessageCause
400Application not foundInvalid applicationId
422Application has no SME Finance referenceApplication not yet fully created

Authorizations

​
apikey
string
header
required

Provide your API key in the 'apikey' header.

Headers

​
x-carbon-key
string
required

Path Parameters

​
applicationId
string
required

Response

200 - application/json

Successful response

The response is of type object.