---
title: "Disburse loan"
method: POST
path: "/loans/{id}/disburse"
tags: ["Loans"]
---

# Disburse loan

`POST /loans/{id}/disburse`

Initiate a payment order using the loan’s disbursement details. The loan will switch to `pending_disbursement`. When the payment order reaches a defined status, the loan account in Mambu Core will be automatically disbursed and the loan will switch to status `active`.

## Path parameters

- `id` string, uuid, required

## Request body

- LoanDisburseParams
  - `reference` string, required — The reference of the payment order.
  - `requested_execution_date` string, date — The date on which the payment order should be executed.

## Response `200`

200

- LoanDetails
  - `id` string, uuid, required — The ID of the loan.
  - `object` string, required — Type of the object, `loan`.
  - `status` 'approved' | 'ready_for_disbursement' | 'pending_disbursement' | 'active' | 'paused' | 'closed', required — The status of the loan.
  - `amount` integer, required — The absolute amount of the loan, in the specified currency's smallest units. For euro loans, the smallest unit is cents. €20 is represented as `2000`.
  - `currency` string, required — The ISO 4217 currency code of the loan.
  - `credit_arrangement_id` string, uuid — The ID of the credit arrangement the loan must be attached to. Must be the ID of an active credit arrangement.
  - `cbs_credit_arrangement_id` string — The ID of the credit arrangement in Mambu Core the loan refers to. Must be left empty if `credit_arrangement_id` is provided.
  - `cbs_source` 'mambu', required — The source of the loan. Only `mambu` is supported.
  - `cbs_account_type` 'loan', required — Always `loan`.
  - `cbs_account_id` string, required — The loan ID in Mambu Core.
  - `disbursement_details` object
    - `connected_account_id` string, uuid — The ID of the connected account used to disburse the loan. Must be the ID of an enabled connected account.
    - `internal_account_id` string, uuid — The ID of the internal account used to disburse the loan (optional). Must be the ID of an active internal account.
    - `receiving_account_id` string, uuid — The ID of the external account receiving the disbursement. Must be the ID of an approved external account.
    - `related_payment_order_ids` string[] — The ID of the payment orders initiated to disburse the loan. See [Payment order object](https://docs.numeral.io/reference/payment-order-object).
  - `repayment_details` object
    - `direct_debit` LoanRepaymentDetailsDirectDebit
      - `direct_debit_mandate_id` string, uuid — The ID of the direct debit mandate used to initiate direct debit collections for the loan. Must be the ID of an active and outgoing direct debit mandate.
    - `credit_transfer` LoanRepaymentDetailsCreditTransfer
      - `receiving_account_id` string, uuid — The ID of the internal account used to receive repayment as credit transfer. Must be the ID of an active internal account.
  - `metadata` object — Additional client data in JSON format. See [Metadata](https://docs.numeral.io/reference/metadata).
  - `custom_fields` CommonCustomFields — Custom fields in JSON `key:value` format. See [Custom fields](https://docs.numeral.io/reference/custom-fields).
  - `created_at` string, date-time, required — The UTC timestamp of the creation of this loan.

## Other responses

- `400` — Validation error.
- `404` — The specified resource was not found.

---

[API](https://skmtc.net/numeral/apis/payments.md) · [All operations](https://skmtc.net/numeral/apis/payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/numeral/payments/versions/220f101cc2ef/schema)