# Create a credit line loan

Creates a credit line loan based on an installment plan. The loan is used for bank statements and should include a  and you must assign a  to it. The credit line must have already been created without any blocks before creating a loan.

Endpoint: POST /v1/persons/{person_id}/credit_lines/{credit_line_id}/loans
Version: 1.0

## Path parameters:

  - `person_id` (string, required)
    The person ID of the customer who has the credit line.

  - `credit_line_id` (string, required)
    The unique credit line ID, generated after a credit line is created.

## Request fields (application/json):

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

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

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

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

  - `reference` (string, required)
    The reference number you internally assigned for the loan.
    Example: "ABH244919"

  - `purpose` (string, required)
    The purpose of the loan.
    Example: "Buying an iphone"

  - `type` (string)
    The type of the loan.
    Enum: "bullet", "installment_plan"

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

  - `interest_rate` (number,null)
    The interest rate applied to the loan.
    Example: 0.11

  - `bullet_repayment_date` (string,null)
    The repayment date of the bullet loan.
    Example: "2023-06-30"

## Response 201 fields (application/json):

  - `type` (string)
    The type of the loan.
    Enum: "bullet", "installment_plan"

  - `status` (string)
    The status of the loan.
    Enum: "payout_pending", "payout_triggered", "created", "repaid"

  - `interest_rate` (number)
    The interest rate to apply to the loan. Only to be used if a special interest rate should apply.
    Example: 0.11

  - `id` (string)
    The unique ID of a loan, generated after creating a loan.
    Example: "f8930e8d3dfa48e4a898d7a97c0d78b4cloa"

  - `effective_interest_rate` (number)
    The effective interest rate to apply to the loan.
    Example: 0.0111

  - `bullet_repayment_date` (string,null)
    The repayment date of the bullet loan.
    Example: "2001-01-01"

## 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 409 fields (application/json):

  - `title` (string)
    Example: "Record Not Unique"

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

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

  - `detail` (string)
    Example: "Could not save `terms_and_conditions_event`."

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