Credit Decisions APIs

Create Manual Review Credit Application Decision

Create a manual review credit decision for a credit application request (before a customer exists).

Credit decision creation requests support Idempotency, ensuring that performing multiple identical requests will have the same result as a single request.

Verb	`POST`
URL	`https://api.s.unit.sh/credit-decisions`
Required Scope	`credit-decisions-write`
Data Type	`manualReviewCreditApplicationDecision`
Timeout (Seconds)	`5`

Attributes

Name	Type	Description
externalApplicationId Required	string	Identifier for client's credit evaluation related to this decision. Max 200 char.
submissionTimestamp Required	timestamp	Timestamp when the corresponding credit application was submitted.
decisionTimestamp Required	timestamp	Timestamp when the credit decision was made.
policyException Required	boolean	One of `true` or `false`.
policyExceptionReason Required	string	Conditional if policyException is `true`. Brief description of reason for policy

exception. Max 200 char. additionalUnderwritingData | json | Object containing key-value pairs of underwriting data per credit policy. idempotencyKey | string | Optional. See Idempotency.

Relationships

Name	Type	Description
creditApplication Required	JSON:API Relationship	The Credit Application for which this credit decision applies to.

Example Request:

curl -X POST 'https://api.s.unit.sh/credit-decisions'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "manualReviewCreditApplicationDecision",
    "attributes": {
      "externalApplicationId": "A1234",
      "submissionTimestamp": "2023-09-19T09:10:09.206Z",
      "decisionTimestamp": "2023-09-19T09:10:09.206Z",
      "policyException": false,
      "additionalUnderwritingData": {
        "someKey1": "someValue1",
        "someKey2": "someValue2",
        "someKey3": "someValue3"
      },
      "idempotencyKey": "3q1a3sbe-se12-4603-8ed0-820923389fb1"
    },
    "relationships": {
      "creditApplication": {
        "data": {
          "type": "creditApplication",
          "id": "12"
        }
      }
    }
  }
}'

Response

Response is a JSON:API document.

201 Created

Name	Type	Description
data	ManualReviewCreditApplicationDecision	The returned resource

after the operation was completed.

Example Response:
{
  "data": {
    "type": "manualReviewCreditApplicationDecision",
    "id": "1",
    "attributes": {
      "createdAt": "2023-07-04T15:21:11.688Z",
      "externalApplicationId": "A1234",
      "evaluationType": "CreditApplication",
      "submissionTimestamp": "2023-09-19T09:10:09.206Z",
      "decisionTimestamp": "2023-09-19T09:10:09.206Z",
      "decision": "ManualReview",
      "policyException": true,
      "policyExceptionReason": "Executive approval",
      "additionalUnderwritingData": {
        "someKey1": "someValue1",
        "someKey2": "someValue2",
        "someKey3": "someValue3"
      }
    },
    "relationships": {
      "application": {
        "data": {
          "type": "application",
          "id": "10005"
        }
      },
      "bank": {
        "data": {
          "type": "bank",
          "id": "10"
        }
      },
      "creditApplication": {
        "data": {
          "type": "creditApplication",
          "id": "12"
        }
      }
    }
  }
}

Create Denied Credit Application Decision

Create a denied credit decision for a credit application request (before a customer exists).

Credit decision creation requests support Idempotency, ensuring that performing multiple identical requests will have the same result as a single request.

Verb	`POST`
URL	`https://api.s.unit.sh/credit-decisions`
Required Scope	`credit-decisions-write`
Data Type	`deniedCreditApplicationDecision`
Timeout (Seconds)	`5`

Attributes

Name	Type	Description
externalApplicationId Required	string	Identifier for client's credit evaluation related to this decision. Max 200 char.
submissionTimestamp Required	timestamp	Timestamp when the corresponding credit application was submitted.
decisionTimestamp Required	timestamp	Timestamp when the credit decision was made.
decisionReason Required	string	Reason for denial per credit policy. Max 200 char.
adverseActionReasons Required	Array of strings	Array of strings representing Adverse action reasons (must have at least one). Max 200 char per reason.
policyException Required	boolean	One of `true` or `false`.
policyExceptionReason Required	string	Conditional if policyException is `true`. Brief description of reason for policy exception. Max 200 char.
additionalUnderwritingData Required	json	Object containing key-value pairs of underwriting data per credit policy.
idempotencyKey Optional	string	See Idempotency.

Relationships

Name	Type	Description
creditApplication Required	JSON:API Relationship	The Credit Application for which this credit decision applies to.

Example Request:

curl -X POST 'https://api.s.unit.sh/credit-decisions'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "deniedCreditApplicationDecision",
    "attributes": {
      "externalApplicationId": "A1234",
      "submissionTimestamp": "2023-09-19T09:10:09.206Z",
      "decisionTimestamp": "2023-09-19T09:10:09.206Z",
      "policyException": false,
      "additionalUnderwritingData": {
        "someKey1": "someValue1",
        "someKey2": "someValue2",
        "someKey3": "someValue3"
      },
      "decisionReason": "this is a decline reason",
      "adverseActionReasons": [
        "adverse action reason 1",
        "adverse action reason 2"
      ],
      "idempotencyKey": "3q1a3sbe-se12-4603-8ed0-820923389fb1"
    },
    "relationships": {
      "creditApplication": {
        "data": {
          "type": "creditApplication",
          "id": "12"
        }
      }
    }
  }
}'

Response

Response is a JSON:API document.

201 Created

Name	Type	Description
data	DeniedCreditApplicationDecision	The returned resource after the operation was completed.

Example Response:
{
  "data": {
    "type": "deniedCreditApplicationDecision",
    "id": "1",
    "attributes": {
      "createdAt": "2023-07-04T15:21:11.688Z",
      "externalApplicationId": "A1234",
      "evaluationType": "CreditApplication",
      "submissionTimestamp": "2023-09-19T09:10:09.206Z",
      "decisionTimestamp": "2023-09-19T09:10:09.206Z",
      "decision": "Denied",
      "policyException": true,
      "policyExceptionReason": "Executive approval",
      "additionalUnderwritingData": {
        "someKey1": "someValue1",
        "someKey2": "someValue2",
        "someKey3": "someValue3"
      },
      "decisionReason": "this is a decline reason",
      "adverseActionReasons": [
        "adverse action reason 1",
        "adverse action reason 2"
      ]
    },
    "relationships": {
      "application": {
        "data": {
          "type": "application",
          "id": "10005"
        }
      },
      "bank": {
        "data": {
          "type": "bank",
          "id": "10"
        }
      },
      "creditApplication": {
        "data": {
          "type": "creditApplication",
          "id": "12"
        }
      }
    }
  }
}

Create Manual Review Credit Limit Decision

Create a manual review credit decision for an existing customer.

Credit decision creation requests support Idempotency, ensuring that performing multiple identical requests will have the same result as a single request.

Verb	`POST`
URL	`https://api.s.unit.sh/credit-decisions`
Required Scope	`credit-decisions-write`
Data Type	`manualReviewCreditLimitDecision`
Timeout (Seconds)	`5`

Attributes

Name	Type	Description
externalApplicationId Required	string	Identifier for client's credit evaluation related to this decision. Max 200 char.
submissionTimestamp Required	timestamp	Timestamp when the corresponding credit application was submitted.
decisionTimestamp Required	timestamp	Timestamp when the credit decision was made.
policyException Required	boolean	One of `true` or `false`.
policyExceptionReason Required	string	Conditional if policyException is `true`. Brief description of reason for policy exception. Max 200 char.
additionalUnderwritingData Required	json	Object containing key-value pairs of underwriting data per credit policy.
idempotencyKey Optional	string	See Idempotency.

Relationships

Name	Type	Description
creditApplication Required	JSON:API Relationship	The Credit Application for which this credit decision applies to.

Example Request:

curl -X POST 'https://api.s.unit.sh/credit-decisions'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "manualReviewCreditLimitDecision",
    "attributes": {
      "externalApplicationId": "A1234",
      "submissionTimestamp": "2023-09-19T09:10:09.206Z",
      "decisionTimestamp": "2023-09-19T09:10:09.206Z",
      "policyException": true,
      "policyExceptionReason": "Executive approval",
      "additionalUnderwritingData": {
        "someKey1": "someValue1",
        "someKey2": "someValue2",
        "someKey3": "someValue3"
      },
      "idempotencyKey": "3q1a3sbe-se12-4603-8ed0-820923389fb1"
    },
    "relationships": {
      "creditApplication": {
        "data": {
          "type": "creditApplication",
          "id": "12"
        }
      }
    }
  }
}'

Response

Response is a JSON:API document.

201 Created

Name	Type	Description
data	ManualReviewCreditLimitDecision	The returned resource after the operation was completed.

Example Response:
{
  "data": {
    "type": "manualReviewCreditLimitDecision",
    "id": "1",
    "attributes": {
      "createdAt": "2023-07-04T15:21:11.688Z",
      "externalApplicationId": "A1234",
      "evaluationType": "CreditLimit",
      "submissionTimestamp": "2023-09-19T09:10:09.206Z",
      "decisionTimestamp": "2023-09-19T09:10:09.206Z",
      "decision": "ManualReview",
      "policyException": true,
      "policyExceptionReason": "Executive approval",
      "additionalUnderwritingData": {
        "someKey1": "someValue1",
        "someKey2": "someValue2",
        "someKey3": "someValue3"
      }
    },
    "relationships": {
      "customer": {
        "data": {
          "type": "customer",
          "id": "10000"
        }
      },
      "creditApplication": {
        "data": {
          "type": "creditApplication",
          "id": "12"
        }
      }
    }
  }
}

Create Approved Credit Limit Decision

Create an approved credit decision for a credit application.

Credit decision creation requests support Idempotency, ensuring that performing multiple identical requests will have the same result as a single request.

Verb	`POST`
URL	`https://api.s.unit.sh/credit-decisions`
Required Scope	`credit-decisions-write`
Data Type	`approvedCreditLimitDecision`
Timeout (Seconds)	`5`

Attributes

Name	Type	Description
externalApplicationId Required	string	Identifier for client's credit evaluation related to this decision. Max 200 char.
submissionTimestamp Required	timestamp	Timestamp when the corresponding credit application was submitted.
decisionTimestamp Required	timestamp	Timestamp when the credit decision was made.
creditLimit Required	Integer (Cents)	Credit limit for application as evaluated per policy.
policyException Required	boolean	One of `true` or `false`.
policyExceptionReason Required	string	Conditional if policyException is `true`. Brief description of reason for policy exception. Max 200 char.
additionalUnderwritingData Required	json	Object containing key-value pairs of underwriting data per credit policy.
idempotencyKey Optional	string	See Idempotency.

Relationships

Name	Type	Description
creditApplication Required	JSON:API Relationship	The Credit Application for which this credit decision applies to.

Example Request:

curl -X POST 'https://api.s.unit.sh/credit-decisions'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "approvedCreditLimitDecision",
    "attributes": {
      "externalApplicationId": "A1234",
      "submissionTimestamp": "2023-09-19T09:10:09.206Z",
      "decisionTimestamp": "2023-09-19T09:10:09.206Z",
      "policyException": true,
      "policyExceptionReason": "Executive approval",
      "additionalUnderwritingData": {
        "someKey1": "someValue1",
        "someKey2": "someValue2",
        "someKey3": "someValue3"
      },
      "creditLimit": 1000000,
      "idempotencyKey": "3q1a3sbe-se12-4603-8ed0-820923389fb1"
    },
    "relationships": {
      "creditApplication": {
        "data": {
          "type": "creditApplication",
          "id": "12"
        }
      }
    }
  }
}'

Response

Response is a JSON:API document.

201 Created

Name	Type	Description
data	ApprovedCreditLimitDecision	The returned resource after the operation was completed.

Example Response:
{
  "data": {
    "type": "approvedCreditLimitDecision",
    "id": "1",
    "attributes": {
      "createdAt": "2023-07-04T15:21:11.688Z",
      "externalApplicationId": "A1234",
      "evaluationType": "CreditLimit",
      "submissionTimestamp": "2023-09-19T09:10:09.206Z",
      "decisionTimestamp": "2023-09-19T09:10:09.206Z",
      "decision": "Approved",
      "policyException": true,
      "policyExceptionReason": "Executive approval",
      "additionalUnderwritingData": {
        "someKey1": "someValue1",
        "someKey2": "someValue2",
        "someKey3": "someValue3"
      },
      "creditLimit": 1000000
    },
    "relationships": {
      "customer": {
        "data": {
          "type": "customer",
          "id": "10000"
        }
      },
      "creditApplication": {
        "data": {
          "type": "creditApplication",
          "id": "12"
        }
      }
    }
  }
}

Create Denied Credit Limit Decision

Create a denied credit decision for an existing customer.

Credit decision creation requests support Idempotency, ensuring that performing multiple identical requests will have the same result as a single request.

Verb	`POST`
URL	`https://api.s.unit.sh/credit-decisions`
Required Scope	`credit-decisions-write`
Data Type	`deniedCreditLimitDecision`
Timeout (Seconds)	`5`

Attributes

Name	Type	Description
externalApplicationId Required	string	Identifier for client's credit evaluation related to this decision. Max 200 char.
submissionTimestamp Required	timestamp	Timestamp when the corresponding credit application was submitted.
decisionTimestamp Required	timestamp	Timestamp when the credit decision was made.
policyException Required	boolean	One of `true` or `false`.
policyExceptionReason Required	string	Conditional if policyException is `true`. Brief description of reason for policy exception. Max 200 char.
additionalUnderwritingData Required	json	Object containing key-value pairs of underwriting data per credit policy.
decisionReason Required	string	Reason for denial per credit policy. Max 200 char.
adverseActionReasons Required	Array of strings	Array of strings representing Adverse action reasons (must have at least one). Max 200 char per reason.
idempotencyKey Optional	string	See Idempotency.

Relationships

Name	Type	Description
creditApplication Required	JSON:API Relationship	The Credit Application for which this credit decision applies to.

Example Request:

curl -X POST 'https://api.s.unit.sh/credit-decisions'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "deniedCreditLimitDecision",
    "attributes": {
      "externalApplicationId": "A1234",
      "submissionTimestamp": "2023-09-19T09:10:09.206Z",
      "decisionTimestamp": "2023-09-19T09:10:09.206Z",
      "policyException": true,
      "policyExceptionReason": "Executive approval",
      "additionalUnderwritingData": {
        "someKey1": "someValue1",
        "someKey2": "someValue2",
        "someKey3": "someValue3"
      },
      "decisionReason": "this is a decline reason",
      "adverseActionReasons": [
        "adverse action reason 1",
        "adverse action reason 2"
      ],
      "idempotencyKey": "3q1a3sbe-se12-4603-8ed0-820923389fb1"
    },
    "relationships": {
      "creditApplication": {
        "data": {
          "type": "creditApplication",
          "id": "12"
        }
      }
    }
  }
}'

Response

Response is a JSON:API document.

201 Created

Name	Type	Description
data	DeniedCreditLimitDecision	The returned resource after the operation was completed.

Example Response:
{
  "data": {
    "type": "deniedCreditLimitDecision",
    "id": "1",
    "attributes": {
      "createdAt": "2023-07-04T15:21:11.688Z",
      "externalApplicationId": "A1234",
      "evaluationType": "CreditLimit",
      "submissionTimestamp": "2023-09-19T09:10:09.206Z",
      "decisionTimestamp": "2023-09-19T09:10:09.206Z",
      "decision": "Denied",
      "policyException": true,
      "policyExceptionReason": "Executive approval",
      "additionalUnderwritingData": {
        "someKey1": "someValue1",
        "someKey2": "someValue2",
        "someKey3": "someValue3"
      },
      "decisionReason": "this is a decline reason",
      "adverseActionReasons": [
        "adverse action reason 1",
        "adverse action reason 2"
      ]
    },
    "relationships": {
      "customer": {
        "data": {
          "type": "customer",
          "id": "10000"
        }
      },
      "creditApplication": {
        "data": {
          "type": "creditApplication",
          "id": "12"
        }
      }
    }
  }
}

Get by Id

Get a credit decision resource by id.

Verb	`GET`
URL	`https://api.s.unit.sh/credit-decisions/{id}`
Required Scope	`credit-decisions`
Timeout (Seconds)	`5`

Response

Response is a JSON:API document.

200 OK

Name	Type	Description
data	CreditDecision	A credit decision resource.

curl -X GET 'https://api.s.unit.sh/credit-decisions/1' \
-H "Authorization: Bearer ${TOKEN}"

List

List credit decision resources. Paging can be applied.

Verb	`GET`
URL	`https://api.s.unit.sh/credit-decisions`
Required Scope	`credit-decisions`
Timeout (Seconds)	`5`

Query Parameters

Name	Type	Default	Description
page[limit]	integer	100	Optional. Maximum number of resources that will be returned. Maximum is 1000 resources. See Pagination.
page[offset]	integer	0	Optional. Number of resources to skip. See Pagination.
filter[orgId]	string	(empty)	Optional. Filters the results by the specified org id.
filter[customerId]	string	(empty)	Optional. Filters the results by the specified customer id.
filter[accountId]	string	(empty)	Optional. Filters the results by the specified account id.
filter[applicationId]	string	(empty)	Optional. Filters the results by the specified application id.
filter[bankId]	string	(empty)	Optional. Filters the results by the specified bank id.
filter[decision]	string	(empty)	Optional. Filters the results by the specified decision (one of `Approved` or `Denied`).
filter[evaluationType]	string	(empty)	Optional. Filters the results by the specified evaluation type (one of `CreditLimit` or `CreditApplication`).

curl -X GET 'https://api.s.unit.sh/credit-decisions?page[limit]=20&page[offset]=10' \
-H "Authorization: Bearer ${TOKEN}"

Response

Response is a JSON:API document.

200 OK

Name	Type	Description
data	Array of CreditDecisions	Array of credit-decisions resources.

Example Response:
{
  "data": [
    {
      "type": "deniedCreditLimitDecision",
      "id": "1",
      "attributes": {
        "createdAt": "2023-07-04T15:21:11.688Z",
        "externalApplicationId": "A1234",
        "evaluationType": "CreditLimit",
        "submissionTimestamp": "2023-09-19T09:10:09.206Z",
        "decisionTimestamp": "2023-09-19T09:10:09.206Z",
        "decision": "Denied",
        "policyException": true,
        "policyExceptionReason": "Executive approval",
        "additionalUnderwritingData": {
          "someKey1": "someValue1",
          "someKey2": "someValue2",
          "someKey3": "someValue3"
        },
        "decisionReason": "this is a decline reason",
        "adverseActionReasons": [
          "adverse action reason 1",
          "adverse action reason 2"
        ]
      },
      "relationships": {
        "customer": {
          "data": {
            "type": "customer",
            "id": "10000"
          }
        },
        "account": {
          "data": {
            "type": "account",
            "id": "10005"
          }
        }
      }
    },
    {
      "type": "deniedCreditApplicationDecision",
      "id": "1",
      "attributes": {
        "createdAt": "2023-07-04T15:21:11.688Z",
        "externalApplicationId": "A1234",
        "evaluationType": "CreditApplication",
        "submissionTimestamp": "2023-09-19T09:10:09.206Z",
        "decisionTimestamp": "2023-09-19T09:10:09.206Z",
        "decision": "Denied",
        "policyException": true,
        "policyExceptionReason": "Executive approval",
        "additionalUnderwritingData": {
          "someKey1": "someValue1",
          "someKey2": "someValue2",
          "someKey3": "someValue3"
        },
        "decisionReason": "this is a decline reason",
        "adverseActionReasons": [
          "adverse action reason 1",
          "adverse action reason 2"
        ]
      },
      "relationships": {
        "application": {
          "data": {
            "type": "application",
            "id": "10005"
          }
        }
      }
    }
  ]
}

Create Manual Review Credit Application Decision​

Attributes​

Relationships​

Response​

201 Created​

Create Denied Credit Application Decision​

Attributes​

Relationships​

Response​

201 Created​

Create Manual Review Credit Limit Decision​

Attributes​

Relationships​

Response​

201 Created​

Create Approved Credit Limit Decision​

Attributes​

Relationships​

Response​

201 Created​

Create Denied Credit Limit Decision​

Attributes​

Relationships​

Response​

201 Created​

Get by Id​

Response​

200 OK​

List​

Query Parameters​

Response​

200 OK​

Create Manual Review Credit Application Decision

Attributes

Relationships

Response

201 Created

Create Denied Credit Application Decision

Attributes

Relationships

Response

201 Created

Create Manual Review Credit Limit Decision

Attributes

Relationships

Response

201 Created

Create Approved Credit Limit Decision

Attributes

Relationships

Response

201 Created

Create Denied Credit Limit Decision

Attributes

Relationships

Response

201 Created

Get by Id

Response

200 OK

List

Query Parameters

Response

200 OK