---
title: "POST /loan-requests"
method: POST
path: "/loan-requests"
tags: ["Loan"]
---

# POST /loan-requests

`POST /loan-requests`

Create an editable DRAFT loan request and return the front redirect URL.

## Request body

- APIPostLoanRequest
  - `invoice` APIRequiredInvoiceCreation
    - `address` Address
      - `address_line_1` string, nullable
      - `address_line_2` string, nullable
      - `city` string, nullable
      - `country` string, nullable
      - `postal_code` string, nullable
      - `state` string, nullable
    - `buyer` CounterpartyCreation, required
      - `address` Address
        - `address_line_1` string, nullable
        - `address_line_2` string, nullable
        - `city` string, nullable
        - `country` string, nullable
        - `postal_code` string, nullable
        - `state` string, nullable
      - `contact` APICounterpartyContact
        - `email` string, email, required
        - `first_name` string, required
        - `last_name` string, required
        - `phone_number` string, required
      - `identifier` string, nullable — Legal identifier of the business, such as its SIRET or SIREN in France. Must not contain spaces.
      - `identifier_type` 'belgium_registration_number' | 'bsn' | 'cif' | 'hr_nummer' | 'kvk' | 'name' | 'nif' | 'siren' | 'siret' | 'steuernummer' | 'vat_number' | 'null', nullable — Type of legal business identifier of the business, such as the SIRET in France.
      - `name` string, nullable — Legal name of the business.
      - `vat_number` string, nullable — VatNumber
    - `currency` 'EUR' | 'GBP', nullable — Currency of the invoice. Use ISO 4217 currency code.
    - `document` string, required — PDF binary (format base64 string)
    - `due_at` string, date-time, required
    - `invoice_number` string, required — Invoice number as displayed on the invoice
    - `invoice_type` 'DEFACTO' | 'USER', nullable
    - `issued_at` string, date-time, required
    - `metadata` object, nullable — This object is yours, it enables you to add custom data.
    - `net_amount` integer, nullable — Amount before tax, in cents
    - `seller` CounterpartyCreation, required
      - `address` Address
        - `address_line_1` string, nullable
        - `address_line_2` string, nullable
        - `city` string, nullable
        - `country` string, nullable
        - `postal_code` string, nullable
        - `state` string, nullable
      - `contact` APICounterpartyContact
        - `email` string, email, required
        - `first_name` string, required
        - `last_name` string, required
        - `phone_number` string, required
      - `identifier` string, nullable — Legal identifier of the business, such as its SIRET or SIREN in France. Must not contain spaces.
      - `identifier_type` 'belgium_registration_number' | 'bsn' | 'cif' | 'hr_nummer' | 'kvk' | 'name' | 'nif' | 'siren' | 'siret' | 'steuernummer' | 'vat_number' | 'null', nullable — Type of legal business identifier of the business, such as the SIRET in France.
      - `name` string, nullable — Legal name of the business.
      - `vat_number` string, nullable — VatNumber
    - `tax_amount` integer, nullable — Amount of tax, in cents
    - `to_account` APIAccountCreation
      - `account_holder` APIBusinessIdentifier
        - `identifier` string, required — Legal identifier of the business, such as its SIRET or SIREN in France. Must not contain spaces.
        - `identifier_type` 'belgium_registration_number' | 'bsn' | 'cif' | 'hr_nummer' | 'kvk' | 'name' | 'nif' | 'siren' | 'siret' | 'steuernummer' | 'vat_number', required — Type of legal business identifier of the business, such as the SIRET in France.
      - `account_number` string, required — The account identifier. Only IBANs are supported at the moment.
      - `account_number_type` 'account_number' | 'iban' | 'internal_id' — The type of account number (e.g. IBAN).
      - `bank_identifier` string, nullable — The identifier of the bank.
      - `bank_identifier_type` 'bic' | 'name' | 'routing_number' | 'undefined' — The type of bank identifier (e.g. BIC).
    - `to_pay_amount` integer, nullable — Remaining amount due by buyer to seller, in cents. Set at 0 for fully paid invoices.
    - `total_amount` integer, required — Sum of net amount and tax amount, in cents
  - `loan_type` 'CREDIT_CARD_FINANCING' | 'FUNDING_OBLIGATION_CONSOLIDATION' | 'INVENTORY_FINANCING' | 'INVOICE_BASED_FINANCING' | 'WALLET_FINANCING' — Drives which financing object the request carries.
  - `metadata` object, nullable — Free-form data echoed back on the loan request.
  - `salt_id` string, nullable — Caller-owned idempotency key: posting the same salt_id twice returns the first request.

## Response `201`

Created

---

[API](https://skmtc.net/getdefacto/apis/api-reference.md) · [All operations](https://skmtc.net/getdefacto/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getdefacto/api-reference/revisions/0a9c1f8784f2/schema)