Attributes and parameters
The table below is the reference information for the API attributes you can use when you create a loan or update a loan. They are the same attributes that show when you receive a response. Required response attributes show in the second table at the bottom.
Request Object: Loan (for POST loan)
Request Object: LoanUpdate (for PUT request)
Request parameters
When you add a date field in a request, the format must be: yyyy-mm-dd.
These fields include BorrowerDOB
and FICODate
and must be in this format: 1970-12-05
For fields that are of type Number (decimal), Arix stores 6 decimal points.
For fields that are of type Integer, you shouldn't send a decimal.
Attribute |
Description |
---|---|
LoanNumber string |
A customer generated loan number. Up to 100 characters. Required |
IssuingBankId
|
The ID of the issuing bank. CRB, NHB or BRB. Required |
Platform
|
The entity that is the intermediary between the customer and CR Required |
LoanType string |
Select from: 1 - HFS (Hold For Sale) 2 - LTHFS (Long Term Hold For Sale) 4 - CRBRetained (Retained) Required |
NoteDate string |
Date the borrower becomes obligated to pay the loan. Date can be the signing date or the funding date (dependent on the loan documents). The format must be: yyyy-mm-dd. Required |
BorrowerLastName string (80 characters) |
Borrower's last name Required |
BorrowerFirstName string (80 characters) |
Borrower's first name Required |
BorrowerDOB string |
Borrower's date of birth The format must be: yyyy-mm-dd. Required |
BorrowerSSN string |
Borrower's Social Security Number Required |
BorrowerAddress string (160 characters) |
Borrower's address Required |
BorrowerCity string (80 characters) |
Borrower's city of residence Required |
BorrowerState string (40 characters) letter code) |
Borrower's State of residence Required |
BorrowerZip string (20 digits) |
Borrower's zip code Required |
LoanAmount number |
Gross dollar amount requested. This amount represents the sum of the origination fee plus (+) net funding amount. Required |
NetFunding number |
Net dollar amount to be funded Required |
Rate number |
Interest rate, as a percent Required |
APR number |
Annual percentage interest rate, as a percent Required |
ServicingBankId string |
ID of the servicing bank Optional |
BorrowerPhone string (30 digits) |
Borrower's phone number Optional |
BorrowerEmail string (100 characters) |
Borrower's email address Optional |
Amortization integer or null |
Number of payments at loan origination to pay off the loan Optional |
Term |
Number of months from loan origination to pay off the loan. Optional |
RateType |
1 - fixed 2- floating Optional |
PriorLoanFlag string (20 characters) |
Red-flag issues in the past, such as bounced checks or insufficient funds. Y - yes N - no Optional |
FICO integeror null |
Borrower's 3-digit FICO score used for risk assessment Optional |
FICODate string |
Date FICO score was obtained The format must be: yyyy-mm-dd. Optional |
CreditGrade string (20 characters) |
Internal grade for loan or from credit policy Optional |
integer or null |
Reason for loan: 1 - student 2 - solar 3 - debt consolidation 4 - home improvement 5 - POS (point of service) 6 - medical 7 - auto 99 - other Optional |
string (500 characters) |
Borrower's stated purpose for the loan Optional |
|
Name of investor who will be purchasing the loan Leave blank for loans retained by CR. Optional |
string (100 characters) |
The entity that handles the servicing of your account, such as billing statements, notices Optional |
string |
Date the borrower applied for the loan. The format must be: yyyy-mm-dd. Optional |
string |
Date the loan was approved The format must be: yyyy-mm-dd. Optional |
string |
Date the lender or investor will purchase the loan from CR The format must be: yyyy-mm-dd. Optional |
string |
Date the first payment is due The format must be: yyyy-mm-dd. Optional |
number |
Dollar amount the borrower was approved to borrow at the time of application. The amount can change before the final loan amount for reasons related to the borrower or lender. Optional |
number |
Dollar amount of monthly payments Optional |
number |
Charge to the borrower for the loan Optional |
string (20 characters) |
Confirm if the borrower is a homeowner Yes or No. Optional |
OpenCreditLines
integer or null |
Number of open credit lines Optional |
integer or null |
Borrower's annual income Optional |
integer or null |
Number of credit inquiries made on the borrower in the last 12 months Optional |
integer or null |
Number of times the borrower has paid their loan late in the last 24 months on all accounts Optional |
integer or null |
Number of open public records, such as bankruptcy, tax liens or judgments Optional |
integer or null |
Number of years the borrower has been employed at their current job Optional |
number |
Percent of available credit used by borrower Optional |
number |
Dollar amount of all revolving debt on the credit report Optional |
integer or null |
Number of accounts the borrower opened in the last 24 months Optional |
integer or null |
Number of open collection accounts, not including collections for medical procedures. Optional |
integer or null |
This field indicates the number of months since the last active public record was on their credit report. A public record may indicate that a borrower stopped paying bills. Optional |
string (500 characters) |
Name of employer. Optional |
decimal |
Debt to Income Ratio Ratio of total monthly payment obligations divided by the monthly income as a decimal, not as a percent. It is calculated differently for each credit policy. It must be submitted as a decimal. The decimal value should be between 0-300. Optional |
string (20 characters) |
If the loan is being made to a covered borrower. Yes or No. Optional |
string (20 characters) |
Military APR A standard calculation used by lenders for loans covered by the Department of Defense's Military Lending Act & Regulation Z. MAPR is required if MLAFLAG = Yes For more information, see: https://www.fdic.gov/regulations/compliance/manual/5/V-13.1.pdf Optional |
string (200 characters) |
Name of party receiving funds via ACH Optional |
integer or null |
If the loan being funded via ACH or same-day ACH. (Same-day ACH requires set up by CR). Optional |
string (80 characters) |
Additional record used for information purposes Optional |
string (80 characters) |
Coborrower's first name Optional |
string (80 characters) |
Coborrower's last name Optional |
string |
Coborrower's date of birth. The format must be: yyyy-mm-dd Optional |
string |
Coborrower's Social Security Number Optional |
string (160 characters) |
Coborrower's address Optional |
string (80 characters) |
Coborrower's city of residence Optional |
string (40 characters) code) |
Coborrower's State of residence Optional |
string (20 digits) |
Coborrower's zip code Optional |
string (30 digits) |
Coborrower's phone number Optional |
string (100 characters) |
Coborrower's email address Optional |
integer or null |
Coborrower's FICO score Optional |
string (200 characters) |
Merchant's name Optional |
number |
Dollar amount paid to merchant Optional |
number |
Refund amount Optional |
string |
Refund date The format must be: yyyy-mm-dd Optional |
string |
Date due for final loan payment The format must be: yyyy-mm-dd. Optional |
number |
Dollar amount of final payment Optional |
number |
Finance charge paid by the borrower Optional |
number |
Total paid by the borrower after all the payments were made Optional |
number |
Number of payments per year Optional |
integer or null |
Frequency of payments: 1 - weekly 2 - semi-monthly 3 - monthly 4 - bi-monthly 5 - other 6 - bi-weekly Optional |
string (20 characters) |
PPD - consumer accounts CCD - corporate accounts Optional |
integer or null |
365 (days) Optional |
string (20 characters) |
ID of the subpool that the loan belongs to Optional |
string (100 characters) |
MPL defined program that the loan belongs to Optional |
string |
Reserved for submitter's IP address Up to 6,000 characters. Required |
Field2
string |
Reserved for Up to 6,000 characters. Required |
Field3
string |
Reserved for Copy
JSON
Up to 6,000 characters. Required |
Field4
string |
Reserved for loan agreement version Up to 6,000 characters. Required |
Field5
string |
Reserved for credit decisioning parameters Copy
JSON
Up to 6,000 characters. Required for any credit information requested by CR |
Field6
string |
Required for business information Up to 6,000 characters. See standard JSON format below |
Field7
string |
Reserved for business owner Information Collect information on controlling person and business owners who own 25% or more. For SBA loans the threshold is 20%. Up to 6,000 characters. See standard JSON format below |
Field6
string |
Required for business information Up to 6,000 characters. See standard JSON format below |
Field7
string |
Reserved for business owner Information Collect information on controlling person and business owners who own 25% or more. For SBA loans the threshold is 20%. Up to 6,000 characters. See standard JSON format below |
Field8
string |
Open field for text. Up to 6,000 characters. Optional |
Field9
string
|
Reserved for fraud vendor raw response Up to 6,000 characters. Optional |
Field10
string |
Open field for text. Up to 6,000 characters. Optional |
Field11
string |
Open field for text. Up to 6,000 characters. Optional |
Field12
string |
Open field for text. Up to 6,000 characters. Optional |
Field13
string |
Open field for text. Up to 6,000 characters. Optional |
Field14
string |
Open field for text. Up to 6,000 characters. Optional |
Field15
string |
Open field for text. Up to 6,000 characters. Optional |
Field16
string |
Reserved for second look investors raw response Up to 6,000 characters. Optional |
Field17
string |
Open field for text. Up to 6,000 characters. Optional |
Field18
string |
Open field for text. Up to 6,000 characters. Optional |
Field19
string |
Open field for text. Up to 6,000 characters. Optional |
Field20
string |
Open field for text. Up to 6,000 characters. Optional |
Field21
byte [ ] |
Optional addition of loan information. Byte array in Base 64. Up to 8,000 characters. Optional |
List { |
Click rail transactions for information on rails Required |
Field 6 Standard Format
JSON
{
"name": "business name",
"tin": "EIN/SSN",
"incDate": "2008-01-01",
"stateIncorp": "AZ",
"countryDomicile": "US",
"phone": "4805477526",
"email": "business email",
"address": "business address",
"city": "business city",
"state": "business state",
"zipCode": "business zip",
"physicalAddress": "the complete physical address of the business if different to the business address. Cannot be PO Box or TBD",
"payroll": "Average monthly payroll",
"businessType": "Business Entity Type - Sole proprietor,Partnership, C-Corp, S-Corp, LLC, Independent contractor, Eligible self-employed individual,501(c)(3) nonprofit, 501(c)(19) veterans organization, Tribal business (sec. 31(b)(2)(C) of Small Business Act), Other",
"businessPurpose": "Business purpose / description",
"industry": "xxx",
"naicsCode": "xxx",
"franchise": "Yes/No",
"RegisteredTradingNames": "",
"ProductServicesOffered": "",
"InsuranceType": "",
"AuthorisedSignatory": "",
"AuthorisedSignatoryVerificationMethod": "",
"BusinessLicenseInformation": "",
"BusinessWebSiteVerification": "Yes|No",
"BusinessAnnualTurnOver": "Gross Annual Revenue, cannot be null",
"BusinessPricingDetails": {
"pricingTier2": "",
"pricingTier3": ""
},
"BusinessCreditLimit": {
"ConsumerCreditLimit": "",
"DailyCreditLimit": "",
"BusinessApprovalException": "Y|N"
}
}
Field 7 Standard Format
JSON
[
{
"name": "owner Name",
"ownershipPer": 24,
"tin": "SSN|EIN|TIN",
"address": "owner address",
"city": "owner city",
"state": "ownerstate",
"zipCode": "owner zip",
"dob": "YYYY-MM-dd",
"phone": "owner phone",
"OwnerFico": 700,
"CIP Decision": "NonDocumentary, Documentary,Other",
"CIP Vendors used": {
"CIP KYC vendor": "eg Socure",
"CIP bank account vendor": "eg Plaid"
},
"CIP Documents used": {
"CIP Document": "eg for a person a Driving license",
"CIP Secondary Document": "eg for a person Utility Bill"
},
"OFAC decision":"True|False",
"OFAC decision source":"",
"CIP Verification used": {
"OCR": "eg Mitek",
"Fraud": "eg Experian Fraud",
"Phone number": "eg White pages",
"type": "Owner | Control person",
"citizenship": "US",
"residencyType": "Permanent Resident Alien | Non-Immigrant Alien | Illegal Alien"
}
},
{}
]
Any vendors noted above are provided for illustration only.
Response attributes
Attribute |
Description |
---|---|
|
The status of a loan |
|
Timestamp of the update |
|
Unique identifier for the loan |
string |
ID of the MPL |
string |
Date of the transaction |