SPENDiD Developer Hub

Our API platform helps you build FinTech apps in radically less time and at lower cost. SPENDiD provides powerful, off-the-shelf functions to generate demographic models, personalized budgets, plus financial health and lending scores.

You'll find comprehensive guides and documentation here to help you start working with our services quickly, as well as support if you get stuck.

Please be sure to also visit our main site at https://www.spendid.io/

Get Started    API Reference

Financial Scoring

The SPENDiD Scores Service uses behavioral modeling to create several index values. Each index has a midpoint value of zero.

We'll detail each score and use cases in the guide.

curl --request POST \
  --url https://api.spendid.io/scores/generate \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'x-api-key: your_api_key' \
  --data '
  {
    "demographics": {
    "age": 25,
    "gross_annual_income": 50000,
    "household_members": 1,
    "is_homeowner": false,
    "net_annual_income": 41004,
    "zip": "35210"
    },
    "budget": {
        "mortgage_and_rent": 6000,
        "vehicle_purchase_and_lease": 3000,
        "savings": 2000
    }
 }'
{
  "demographics": {
    "age": 25,
    "gross_annual_income": 50000,
    "household_members": 1,
    "is_homeowner": false,
    "net_annual_income": 41004,
    "zip": "35210"
  },
  "budget": {
    "mortgage_and_rent": 6000,
    "vehicle_purchase_and_lease": 3000,
    "savings": 2000
  }
}
{
  "breakeven": "8.46",
  "saving": "3.58",
  "lending": "2.44"
}

BREAKEVEN Score

This calculation is made possible by the Account Holder's demographic profile, income, and three core fixed expense inputs of Mortgage/Rent, Vehicle Payments, and other Monthly Debt Service. Given this information SPENDiD instantly calculates the Account Holder's relative ability vs their Peers to meet these specifically input obligations, plus all other expected expenses based on their demographic profile, and still "BREAKEVEN" on a cash-flow basis for an average month. A BREAKEVEN Score of zero is considered "Average". The further the BREAKEVEN Score is below (or above) zero is an indicator of the relative difficulty (or ease) that the Account Holder is likely to experience in their effort to BREAKEVEN. This proprietary metric is offered primarily as an additional guiding factor for the Financial Institution in their evaluation of the Account Holder's relative cash flow strength, and to assist the FI toward the creation of a more personalized financial journey for this specific customer.

LENDING Score

The user's BREAKEVEN Score can then be "contextualized" or weighted based on the relative absolute $ amount of the Discretionary funds excess or shortfall for that particular customer/account holder. For example, a +30.1 BREAKEVEN Score for an account holder earning $38,000 isn't of the same marketing value to a Bank or Credit Card provider as someone with a +30.1 BREAKEVEN Score earning $150,000. The resulting weighted LENDING Score would reflect this adjusted relative value (or risk) of each account, making marketing or risk prioritization simpler and more efficiently focused for the financial institution.

BUDGET Score

Intended as a potential metric for use by the Account Holder, this calculation uses the same inputs detailed in the BREAKEVEN Score but goes further by allowing the user to set as "FIXED" any other expense categories they may choose, rather than accept the calculated SPENDiD Budget amount. Plus, the BUDGET Score takes into consideration the user's Monthly Savings Goal, treating it as an important FIXED expense. Given this more comprehensive user-centric data, SPENDiD returns a validated, crowd-sourced, categorized budget and instant calculation of the User's personalized BUDGET Score. Again, the further the BUDGET Score is below (or above) zero is an indicator of the relative difficulty (or ease) that the Account Holder is likely to experience in their ability to achieve their Savings Goal.

Updated 2 months ago

Financial Scoring


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.