---
updatedAt: 2026-07-24T09:54:53.000Z
agentTools:
  projectIndex: https://devportal.fintensy.com/llms.txt
---

# Creates a new loan request.

POST: /api/loan-requests

# OpenAPI definition

```json
{
  "openapi": "3.0.4",
  "info": {
    "title": "Mozzeno API definitions",
    "description": "An overview of the API definitions used in the Mozzeno application.",
    "contact": {
      "name": "Fintensy",
      "url": "https://www.fintensy.com/"
    },
    "version": "v1"
  },
  "paths": {
    "/api/loan-requests": {
      "post": {
        "tags": [
          "LoanRequests"
        ],
        "summary": "Creates a new loan request.",
        "description": "POST: /api/loan-requests",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Mozzeno_Web_Api_Contracts_Models_External_LoanRequests_CreateLoanRequestInputModel"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/Mozzeno_Web_Api_Contracts_Models_External_LoanRequests_CreateLoanRequestInputModel"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "The entity has been created.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The input model is not valid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Mozzeno_Web_Api_ErrorModel"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Mozzeno_Enums_CreditCategory": {
        "enum": [
          0,
          1,
          2,
          3,
          4,
          5,
          6,
          7,
          8,
          9
        ],
        "type": "integer",
        "description": "0 = Unknown, 1 = Other, 2 = Loan, 3 = PersonalLoan, 4 = Leasing, 5 = CreditLine, 6 = Mortgage, 7 = Overdraft, 8 = Bullet, 9 = CreditCard",
        "format": "int32"
      },
      "Mozzeno_Enums_LoanApplicant_ContractType": {
        "enum": [
          0,
          1,
          2,
          3,
          4,
          5
        ],
        "type": "integer",
        "description": "0 = Unknown, 1 = OpenEnded, 2 = FixedTerm, 3 = Interim, 4 = Formation, 5 = Freelance",
        "format": "int32"
      },
      "Mozzeno_Enums_LoanApplicant_EducationLevel": {
        "enum": [
          0,
          1,
          2,
          3,
          4,
          5
        ],
        "type": "integer",
        "description": "0 = Undefined, 1 = None, 2 = Primary, 3 = Secondary, 4 = Superior, 5 = University",
        "format": "int32"
      },
      "Mozzeno_Enums_LoanApplicant_HousingStatus": {
        "enum": [
          0,
          1,
          2,
          3,
          4,
          5,
          6,
          7
        ],
        "type": "integer",
        "description": "0 = Undefined, 1 = Owned, 2 = Rental, 3 = WithParents, 4 = WithSpouse, 5 = WithFamily, 6 = WithFriends, 7 = Others",
        "format": "int32"
      },
      "Mozzeno_Enums_LoanApplicant_HousingStatusSince": {
        "enum": [
          0,
          1,
          2,
          3,
          4
        ],
        "type": "integer",
        "description": "0 = Undefined, 1 = LessThan2Years, 2 = Between2And5Years, 3 = Between5And10Years, 4 = MoreThan10Years",
        "format": "int32"
      },
      "Mozzeno_Enums_LoanApplicant_JobTitle": {
        "enum": [
          0,
          1,
          2,
          3,
          4,
          5,
          6,
          7,
          8,
          9,
          10,
          11,
          12,
          13,
          14
        ],
        "type": "integer",
        "description": "0 = Unknown, 1 = Employee, 2 = Worker, 3 = Freelance, 4 = Retired, 5 = Student, 6 = Unemployed, 7 = SocialWelfare, 8 = Professional, 9 = WithoutActivity, 10 = NoIncome, 11 = Horeca, 12 = PublicFunction, 13 = CompanyOwner, 14 = SocialSecurity",
        "format": "int32"
      },
      "Mozzeno_Enums_LoanApplicant_MaritalStatusSince": {
        "enum": [
          0,
          1,
          2,
          3,
          4,
          5
        ],
        "type": "integer",
        "description": "0 = Undefined, 1 = LessThan1Year, 2 = Between1And3Years, 3 = Between3And5Years, 4 = MoreThan5, 5 = NotApplicable",
        "format": "int32"
      },
      "Mozzeno_Enums_LoanApplicant_MaritalStatuses": {
        "enum": [
          0,
          1,
          2,
          3,
          4,
          5,
          6
        ],
        "type": "integer",
        "description": "0 = Undefined, 1 = Single, 2 = Married, 3 = Divorced, 4 = Separated, 5 = Widowed, 6 = CivilUnion",
        "format": "int32"
      },
      "Mozzeno_Enums_LoanApplicant_MatrimonialPropertyRegime": {
        "enum": [
          0,
          1,
          2
        ],
        "type": "integer",
        "description": "0 = Undefined, 1 = Community, 2 = Separation",
        "format": "int32"
      },
      "Mozzeno_Enums_LoanApplicant_PersonRole": {
        "enum": [
          0,
          1,
          2,
          3
        ],
        "type": "integer",
        "description": "0 = Unknown, 1 = Primary, 2 = Secondary, 3 = Guarantor",
        "format": "int32"
      },
      "Mozzeno_Enums_LoanApplication_PreferredDurationMode": {
        "enum": [
          0,
          1
        ],
        "type": "integer",
        "description": "0 = UseAsMinimumDuration, 1 = UseAsFixedDuration",
        "format": "int32"
      },
      "Mozzeno_Enums_Tracking_AwarenessSource": {
        "enum": [
          0,
          1,
          2,
          3,
          4,
          5,
          6,
          7
        ],
        "type": "integer",
        "description": "0 = Unknown, 1 = SearchEngineGoogleExample, 2 = ComparisonSite, 3 = FacebookInstagramLinkedin, 4 = Youtube, 5 = FriendsHearsay, 6 = PressArticle, 7 = Other",
        "format": "int32"
      },
      "Mozzeno_Web_Api_Contracts_Models_External_LoanRequests_CreateLoanRequestInputModel": {
        "type": "object",
        "properties": {
          "branch_id": {
            "type": "string",
            "format": "uuid"
          },
          "tracking": {
            "$ref": "#/components/schemas/Mozzeno_Web_Api_Contracts_Models_External_LoanRequests_TrackingInputModel"
          },
          "requested_amount": {
            "type": "number",
            "format": "double"
          },
          "currency": {
            "type": "string",
            "nullable": true
          },
          "loan_purpose_id": {
            "type": "string",
            "format": "uuid"
          },
          "loan_purpose_explanation": {
            "type": "string",
            "nullable": true
          },
          "preferred_duration": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "preferred_duration_mode": {
            "$ref": "#/components/schemas/Mozzeno_Enums_LoanApplication_PreferredDurationMode"
          },
          "order_reference": {
            "type": "string",
            "nullable": true
          },
          "pricing_key": {
            "type": "string",
            "nullable": true
          },
          "loan_applicants": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Mozzeno_Web_Api_Contracts_Models_External_LoanRequests_LoanApplicantInputModel"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Mozzeno_Web_Api_Contracts_Models_External_LoanRequests_CreditInformationInputModel": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "total_amount": {
            "type": "number",
            "format": "double"
          },
          "instalment_amount": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "rate_apr": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "currency": {
            "type": "string",
            "nullable": true
          },
          "duration": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "loan_purpose_id": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "credit_category": {
            "$ref": "#/components/schemas/Mozzeno_Enums_CreditCategory"
          },
          "started_at": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "lender": {
            "type": "string",
            "nullable": true
          },
          "consolidate": {
            "type": "boolean"
          },
          "professional": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "Mozzeno_Web_Api_Contracts_Models_External_LoanRequests_FinancialSourceInformationInputModel": {
        "type": "object",
        "properties": {
          "financial_source_id": {
            "type": "string",
            "format": "uuid"
          },
          "currency": {
            "type": "string",
            "nullable": true
          },
          "amount": {
            "type": "number",
            "format": "double"
          }
        },
        "additionalProperties": false
      },
      "Mozzeno_Web_Api_Contracts_Models_External_LoanRequests_LoanApplicantInputModel": {
        "type": "object",
        "properties": {
          "role": {
            "$ref": "#/components/schemas/Mozzeno_Enums_LoanApplicant_PersonRole"
          },
          "language": {
            "type": "string",
            "nullable": true
          },
          "first_name": {
            "type": "string",
            "nullable": true
          },
          "last_name": {
            "type": "string",
            "nullable": true
          },
          "email": {
            "type": "string",
            "nullable": true
          },
          "gender": {
            "type": "string",
            "nullable": true
          },
          "mobile_phone_number": {
            "type": "string",
            "nullable": true
          },
          "street": {
            "type": "string",
            "nullable": true
          },
          "street_number": {
            "type": "string",
            "nullable": true
          },
          "street_additional_information": {
            "type": "string",
            "nullable": true
          },
          "zipcode": {
            "type": "string",
            "nullable": true
          },
          "city": {
            "type": "string",
            "nullable": true
          },
          "country": {
            "type": "string",
            "nullable": true
          },
          "housing_status": {
            "$ref": "#/components/schemas/Mozzeno_Enums_LoanApplicant_HousingStatus"
          },
          "housing_status_since": {
            "$ref": "#/components/schemas/Mozzeno_Enums_LoanApplicant_HousingStatusSince"
          },
          "nationality": {
            "type": "string",
            "nullable": true
          },
          "national_identification_number": {
            "type": "string",
            "nullable": true
          },
          "identity_card_number": {
            "type": "string",
            "nullable": true
          },
          "identity_card_expires_at": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "identity_card_issue_place": {
            "type": "string",
            "nullable": true
          },
          "identity_card_issued_at": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "date_of_birth": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "birth_place": {
            "type": "string",
            "nullable": true
          },
          "birth_country": {
            "type": "string",
            "nullable": true
          },
          "in_country_since": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "marital_status": {
            "$ref": "#/components/schemas/Mozzeno_Enums_LoanApplicant_MaritalStatuses"
          },
          "marital_status_since": {
            "$ref": "#/components/schemas/Mozzeno_Enums_LoanApplicant_MaritalStatusSince"
          },
          "matrimonial_property_regime": {
            "$ref": "#/components/schemas/Mozzeno_Enums_LoanApplicant_MatrimonialPropertyRegime"
          },
          "education_level": {
            "$ref": "#/components/schemas/Mozzeno_Enums_LoanApplicant_EducationLevel"
          },
          "education_type": {
            "type": "string",
            "nullable": true
          },
          "current_job_title": {
            "$ref": "#/components/schemas/Mozzeno_Enums_LoanApplicant_JobTitle"
          },
          "current_job_position": {
            "type": "string",
            "nullable": true
          },
          "current_job_started_at": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "employer": {
            "type": "string",
            "nullable": true
          },
          "employer_phone_number": {
            "type": "string",
            "nullable": true
          },
          "employer_street": {
            "type": "string",
            "nullable": true
          },
          "employer_street_number": {
            "type": "string",
            "nullable": true
          },
          "employer_street_additional_information": {
            "type": "string",
            "nullable": true
          },
          "employer_zipcode": {
            "type": "string",
            "nullable": true
          },
          "employer_city": {
            "type": "string",
            "nullable": true
          },
          "employer_country": {
            "type": "string",
            "nullable": true
          },
          "contract_type": {
            "$ref": "#/components/schemas/Mozzeno_Enums_LoanApplicant_ContractType"
          },
          "vat_number": {
            "type": "string",
            "nullable": true
          },
          "politically_exposed_person": {
            "type": "boolean"
          },
          "financial_sources": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Mozzeno_Web_Api_Contracts_Models_External_LoanRequests_FinancialSourceInformationInputModel"
            },
            "nullable": true
          },
          "other_income_origin": {
            "type": "string",
            "nullable": true
          },
          "persons_in_charge": {
            "type": "integer",
            "format": "int32"
          },
          "dependent_children": {
            "type": "integer",
            "format": "int32"
          },
          "monthly_expense_children": {
            "type": "number",
            "format": "double"
          },
          "monthly_expense_housing": {
            "type": "number",
            "format": "double"
          },
          "monthly_expense_mortgage": {
            "type": "number",
            "format": "double"
          },
          "monthly_expense_alimony": {
            "type": "number",
            "format": "double"
          },
          "monthly_expense_others": {
            "type": "number",
            "format": "double"
          },
          "monthly_expense_others_origin": {
            "type": "string",
            "nullable": true
          },
          "other_credits": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Mozzeno_Web_Api_Contracts_Models_External_LoanRequests_CreditInformationInputModel"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Mozzeno_Web_Api_Contracts_Models_External_LoanRequests_TrackingInputModel": {
        "type": "object",
        "properties": {
          "source": {
            "type": "string",
            "nullable": true
          },
          "campaign": {
            "type": "string",
            "nullable": true
          },
          "medium": {
            "type": "string",
            "nullable": true
          },
          "content": {
            "type": "string",
            "nullable": true
          },
          "google_click_id": {
            "type": "string",
            "nullable": true
          },
          "awareness_source": {
            "$ref": "#/components/schemas/Mozzeno_Enums_Tracking_AwarenessSource"
          },
          "awareness_source_explanation": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Mozzeno_Web_Api_ErrorInformationModel": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "nullable": true
          },
          "actual_value": {
            "type": "string",
            "nullable": true
          },
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "min_length": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "max_length": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Mozzeno_Web_Api_ErrorModel": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "nullable": true
          },
          "message": {
            "type": "string",
            "nullable": true
          },
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Mozzeno_Web_Api_ErrorInformationModel"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      }
    }
  }
}
```