# Processes affordability for the transactions supplied.

Maximum of 12 months returned

Endpoint: POST /insights-engine/v1/affordability
Version: all
Security: Bearer

## Query parameters:

  - `useLegacyCategorisation` (boolean)
    Flag whether to use the latest or legacy categorisation service

  - `confidenceFloor` (number)
    Value from 0.0 to 1.0 which will return transactions as uncategorised if the category confidence is below this value

## Request fields (application/json-patch+json):

  - `referenceId` (string, required)
    Unique identifier for the account to have the affordability calculated

  - `includeFlexibleCosts` (boolean)
    Includes flexible costs in the affordability calculation

  - `currencyCode` (string, required)
    Currency code for the transactions, currently supported codes are GBP and USD.

  - `countryCode` (string, required)
    Country code for the account of the transactions

  - `transactions` (array,null)

  - `transactions.transactionId` (string, required)
    Unique transaction id assigned by the provider

  - `transactions.description` (string, required)
    A description line for the transaction

  - `transactions.amount` (number, required)
    The quantity of money

  - `transactions.creditDebitIndicator` (string, required)
    Enum: "Credit", "Debit"

  - `transactions.status` (string, required)
    Enum: "Pending", "Booked"

  - `transactions.bookingDate` (string, required)
    ISO8601 formatted date string containing the date the transaction is expected to be settled(or did settle)

## Response 200 fields (application/json):

  - `referenceId` (string,null)
    Unique identifier for the categorisation request

  - `countryCode` (string,null)
    Country code for the account of the transactions

  - `currencyCode` (string,null)
    Currency code for the transactions, currently supported codes are GBP and USD.

  - `affordabilityMonths` (array,null)
    List of Month Affordability

  - `affordabilityMonths.month` (integer)

  - `affordabilityMonths.year` (integer)

  - `affordabilityMonths.monthDateTime` (string)

  - `affordabilityMonths.calculatedIncome` (number)

  - `affordabilityMonths.fixedCosts` (number)

  - `affordabilityMonths.flexibleCosts` (number)

  - `affordabilityMonths.debtFees` (number)

  - `affordabilityMonths.affordability` (number)

  - `estimatedCalculatedIncome` (number)
    Calculated Income Estimate

  - `estimatedFixedCosts` (number)
    Calculated Fixed Cost Estimate

  - `estimatedFlexibleCosts` (number)
    Calculated Flexible Costs Estimate

  - `estimatedDebtFees` (number)
    Calculated Debt Fees Estimate

  - `estimatedAffordability` (number)
    Calculated Affordability Estimate

## Response 400 fields (application/json):

  - `code` (string,null)
    Error code.

  - `description` (string,null)
    Error message.

  - `details` (string,null)
    Error details.

  - `correlationId` (string,null)
    User transaction tracking Id

## Response 403 fields (application/json):

  - `code` (string,null)
    Error code.

  - `description` (string,null)
    Error message.

  - `details` (string,null)
    Error details.

  - `correlationId` (string,null)
    User transaction tracking Id

## Response 500 fields (application/json):

  - `code` (string,null)
    Error code.

  - `description` (string,null)
    Error message.

  - `details` (string,null)
    Error details.

  - `correlationId` (string,null)
    User transaction tracking Id