# Retrieve a loan

Returns the details of the loan specified in the request URL.

Endpoint: GET /v1/loans/{loan_id}
Version: 1.0

## Path parameters:

  - `loan_id` (string, required)
    The ID of the loan to be retrieved.

## Response 200 fields (application/json):

  - `id` (string, required)
    The ID of the loan.
    Example: "c13447d659db4cdcb450b977f8f25c57cloa"

  - `status` (string, required)
    The loan's status.
    Enum: "payout_initiation_pending", "payout_initiation_blocked", "payout_pending", "payout_issued", "all_obligations_met"

  - `person_id` (string, required)
    The person ID of the customer getting the loan.
    Example: "547a870b2c8461a3104559369d09265dcper"

  - `billing_account_id` (string,null, required)
    The ID of the customer's billing account from which all the loan payments will be debited.
    Example: "1d0e52af0a62b4b44d8c54a87a7fc6a7cacc"

  - `amount` (any, required)
    The loan amount.

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

  - `interest_rate` (number, required)
    The monthly interest rate applied to a loan.
    Example: 0.0499

  - `recipient_iban` (string, required)
    The IBAN to which the loan is paid out.
    Example: "DE88888881010987654321"

  - `repayment_begin_date` (string, required)
    The date when the loan's first monthly installment is due.
    Example: "2020-05-16"

  - `payout_date` (string, required)
    The date when the loan will be paid out.
    Example: "2020-05-16"

  - `interest_start_date` (string, required)
    The date when the interest starts accruing on a loan.
    Example: "2021-06-16"

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

  - `overdue_amount` (object, required)
    An object representing the loan overdue amount.

  - `created_at` (string, required)
    The date when the loan was created.
    Example: "2021-06-16T10:22:38"

  - `total_loan_expenses` (object,null)
    An object representing the loan total expenses (e.g., costs and expenses the lender incurred during a loan lifecycle).

  - `status_reason` (string,null)
    Additional context around the loan status.
    Enum: "upfront_subsidy_pull_failed_collateral_account_not_set", "upfront_subsidy_pull_failed_debit_blocked", "upfront_subsidy_pull_failed_insufficient_funds"

  - `repayment_plan_updated_at` (string,null)
    The date when the loan's repayment plan was last updated.
    Example: "2021-04-16T13:52:05Z"

  - `repayment_plan_created_at` (string,null)
    The date when the loan's repayment plan was created.
    Example: "2020-04-16T13:52:05Z"

  - `reference` (string,null)
    A reference for the loan.

  - `purpose` (string,null)
    The purpose of the loan.
    Example: "Buying a car."

  - `monthly_payment` (object,null)
    An object representing the loan monthly installment amount.

  - `maturity_date` (string,null)
    The date when the final loan payment is due.
    Example: "2022-05-16"

  - `loan_account_id` (string,null)
    The account ID to which the loan is attached.
    Example: "adc123a45d6d7cf8fbfeed537ba919d5cacc"

  - `loan_account_iban` (string,null)
    The IBAN of the account to which the loan is attached.
    Example: "DE72110101014351836685"

  - `billing_account_iban` (string,null)
    The IBAN of the customer's billing account associated with the loan.
    Example: "DE72110101014351836685"

  - `annual_percentage_rate` (number)
    A percentage that represents the yearly cost of funds over the term of a loan. It includes interest, fees and additional costs associated with a loan.

## Response 404 fields (application/json):

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

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

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

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

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