---
title: "List loans"
method: GET
path: "/loans"
tags: ["Loans"]
---

# List loans

`GET /loans`

List and filter loans.

## Query parameters

- `limit` integer
- `starting_after` string, uuid
- `sort_order` 'asc' | 'desc'
- `start_date` string, date
- `end_date` string, date
- `status` 'approved' | 'ready_for_disbursement' | 'pending_disbursement' | 'active' | 'paused' | 'closed'

## Response `200`

200

- LoanSearchResult
  - `records` 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.

---

[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)