# Create business fronting loan or fronting factoring application

Creates a fronting loan or fronting factoring application and assigns it to the business with the  specified in the request URL. The payload of this endpoint includes all the required financial information and account data about the business, which the credit scorer uses to initiate a series of credit checks to determine the business's credit risk and eligibility.

Endpoint: POST /v1/businesses/{business_id}/fronting_loan_applications
Version: 1.0

## Path parameters:

  - `business_id` (string, required)
    The ID of the business applying for a fronting loan or fronting factoring.

## Request fields (application/json):

  - `requested_amount` (object, required)
    The requested loan amount.
    Example: {"currency":"EUR","unit":"cents","value":1000}

  - `requested_amount.value` (integer, required)
    The amount value
    Example: 1000

  - `requested_amount.currency` (string, required)
    The currency of the given value. Only EURO is currently supported.
    Example: "EUR"

  - `requested_amount.unit` (string, required)
    The unit of the given value.
    Enum: "cents"

  - `agio` (number)
    The credit commission amount.

  - `creditreform_pd` (string)
    The business's probability of default as scored by any credit risk service provider, e.g., Creditreform.
    Example: "0.10"

  - `creditreform_score` (integer)
    The business's credit score as scored by any credit risk service provider, e.g., Creditreform.
    Example: 2

  - `duration` (integer)
    The number of months over which the loan will be repaid.
    Example: 24

  - `effective_interest_rate` (number)
    The effective annual interest rate applied to the loan.
    Example: 0.309

  - `factoring_fee` (object,null)
    Factoring fee
    Example: {"currency":"EUR","unit":"cents","value":1000}

  - `minimum_credit_risk_criteria` (object,null)
    Minimum credit risk criteria fields for scorer

  - `nominal_interest_rate` (number)
    The nominal interest rate applied to the loan.
    Example: 0.299

  - `partner_contact_name` (string)
    Your internal contact name for the business.
    Example: "Daniel Schmidt"

  - `partner_contact_number` (string)
    Your internal contact number for the business.
    Example: "+49345195891"

  - `partner_reference_number` (string)
    our internal reference number for the business. Acts as an idempotency key.
    Example: "tf2df3ceac0e384352b78cb6987d1d987"

  - `partner_score` (string)
    The score assigned to the business by your internal scoring flow.
    Example: "AA"

  - `purpose` (string)
    The purpose of the loan.
    Example: "Buying office equipment, factoring of receivables, etc."

  - `purpose_description` (string)
    Additional information about the purpose of the loan.

  - `recipient_iban` (string)
    The IBAN of the loan's recipient, to which the loan will be paid out.
    Example: "DE92370601930002130041"

  - `recipient_name` (string)
    The name of the loan recipient.
    Example: "Max Mustermann"

  - `transaction_description` (string)
    The transaction reference, which the recipient will see. Only use characters allowed by SEPA in this field.
    Example: "Example transaction."

  - `transaction_end_to_end_id` (string)
    SEPA identifier (provided by the end customer who initiated the SEPA transaction), routed through the whole payment process. (Max 35 characters without whitespace)
    Example: "DDHHDHG333243"

## Response 201 fields (application/json):

  - `id` (string, required)
    The unique ID of the business fronting loan application.
    Example: "89d4eaaa73ec4a73a0b9d40fb5d9da9cbfla"

  - `status` (string, required)
    The status of the business fronting loan application.
    Enum: "scoring_pending", "risk_report_pending", "pending", "identification_pending", "cdd_pending", "approved", "rejected", "loan_created"

  - `creditreform_pd` (string,null, required)
    The business's probability of default as scored by any credit risk service provider, e.g., Creditreform.
    Example: "0.10"

  - `creditreform_score` (integer,null, required)
    The business's credit score as scored by any credit risk service provider, e.g., Creditreform.
    Example: 2

  - `partner_reference_number` (string, required)
    Your internal reference number for the business. Acts as an idempotency key.
    Example: "tf2df3ceac0e384352b78cb6987d1d987"

  - `partner_score` (string, required)
    The score assigned to the business by your internal scoring flow.
    Example: "AA"

  - `purpose` (string, required)
    The purpose of the loan.
    Example: "Buying office equipment, factoring of receivables, etc."

  - `recipient_iban` (string, required)
    The IBAN of the loan's recipient, to which the loan will be paid out.
    Example: "DE92370601930002130041"

  - `recipient_name` (string, required)
    The name of the loan recipient.
    Example: "Daniel Schmidt"

  - `requested_amount` (object, required)
    The requested loan amount.
    Example: {"currency":"EUR","unit":"cents","value":1000}

  - `requested_amount.value` (integer, required)
    The amount value
    Example: 1000

  - `requested_amount.currency` (string, required)
    The currency of the given value. Only EURO is currently supported.
    Example: "EUR"

  - `requested_amount.unit` (string, required)
    The unit of the given value.
    Enum: "cents"

  - `agio` (number,null)
    The credit commission amount.

  - `duration` (integer,null)
    The number of months over which the loan will be repaid.
    Example: 24

  - `effective_interest_rate` (number,null)
    The effective annual interest rate applied to the loan.
    Example: 0.309

  - `identification_id` (string,null)
    The unique ID of the identification resource created for the business.
    Example: "1063504cf74919f60ae4c806bdc9ce75bid"

  - `minimum_credit_risk_criteria` (object,null)
    Minimum credit risk criteria fields for scorer

  - `nominal_interest_rate` (number,null)
    The nominal interest rate applied to the loan.
    Example: 0.299

  - `partner_contact_name` (string,null)
    Your internal contact name for the business.
    Example: "Daniel Schmidt"

  - `partner_contact_number` (string,null)
    Your internal contact number for the business.
    Example: "+49345195891"

  - `purpose_description` (string,null)
    Additional information about the purpose of the loan. In case of factoring, include the invoice number and reference in this field.
    Example: "Buying office equipment for new headquarters."

  - `transaction_description` (string,null)
    The transaction reference, which the recipient will see. Only use characters allowed by SEPA in this field.
    Example: "Example transaction"

  - `transaction_end_to_end_id` (string,null)
    SEPA identifier (provided by the end customer who initiated the SEPA transaction), routed through the whole payment process. (Max 35 characters without whitespace)
    Example: "DDHHDHG333243"

## Response 400 fields (application/json):

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `detail` (string)
    Example: "Cannot connect to database."

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `title` (string)
    Example: "Failed to build pagination headers."

## Response 403 fields (application/json):

  - `code` (string)
    Example: "unauthorized_action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `title` (string)
    Example: "Unauthorized Action"

## Response 404 fields (application/json):

  - `code` (string)
    Example: "model_not_found"

  - `detail` (string)
    Example: "Couldn't find 'Account' for id 'DE24112233445566'."

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "404"

  - `title` (string)
    Example: "Model Not Found"

## Response 422 fields (application/json):

  - `errors` (array, required)

  - `errors.id` (string, required)
    A UUID, preferably the request ID

  - `errors.status` (integer, required)
    The HTTP status

  - `errors.code` (string, required)
    some_computer_friendly_string

  - `errors.title` (string, required)
    Some short human friendly string

  - `errors.detail` (string, required)
    Some human friendly-ish detail: field is required

  - `errors.backtrace` (array,null)
    Optional array of backtrace lines

  - `errors.source` (object,null)
    Optional computer-friendly error source description
    Example: {"field":"name","message":"is_required"}

  - `errors.source.field` (string, required)
    Example: "name"

  - `errors.source.message` (string, required)
    Example: "is_required"