LElead
Funding

Create a Funding

Changed on

Create a Funding to disburse principal from a User Credit Balance to an Account Number. The response returns the Funding with status: processing. See Funding Object for the checks Lead runs on create.

post/v2/fundings

Request

  • Base URL
    https://api.sandbox.lead.bank
  • URL
    https://api.sandbox.lead.bank/v2/fundings
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring required

Idempotency key

Request body

user_credit_balance_idstring required

ID of the User Credit Balance this funding draws against. The balance must be active; if it has an expected_maturity_date, that date must not be in the past.

account_number_idstring required

The ID of the Lead Bank Account Number object.

currency_code'USD' required

A three-letter currency code as defined in ISO 4217.

amountinteger required

The total principal to disburse, in minor units. Must be greater than zero. For a non_revolving balance, the sum of this amount and all prior processing or posted fundings on the balance must not exceed its max_funding_amount.

metadataobject

Additional metadata associated with the funding.

Example request

{
  "user_credit_balance_id": "user_credit_balance_1HCpXwx2EK9oYluWbacgeCnFcLf",
  "account_number_id": "account_number_xyz123",
  "currency_code": "USD",
  "amount": 1000000,
  "metadata": {
    "loan_id": "201681646780571"
  }
}

Response

The Funding object was accepted for processing.

idstring required

Unique ID of the Funding object.

user_credit_balance_idstring required

ID of the User Credit Balance this funding draws against.

account_number_idstring required

The ID of the Lead Bank Account Number object.

currency_code'USD' required

A three-letter currency code as defined in ISO 4217.

amountinteger required

The total principal disbursed, in minor units.

metadataobject

Additional metadata associated with the funding.

core_transaction_idstring nullable required

ID of the Core Transaction that credited the destination balance. null until the funding is posted.

status'processing' | 'posted' | 'rejected' required

The current status of the Funding object.

created_atstring date-time required

The ISO-8601 timestamp at which the Funding object was created.

updated_atstring date-time required

The ISO-8601 timestamp at which the Funding object was last updated.

Example response

{
  "id": "funding_0o5Fs0EELR0fUjHjbCnEtdUwQe3",
  "user_credit_balance_id": "user_credit_balance_1HCpXwx2EK9oYluWbacgeCnFcLf",
  "account_number_id": "account_number_xyz123",
  "currency_code": "USD",
  "amount": 1000000,
  "metadata": {
    "loan_id": "201681646780571"
  },
  "core_transaction_id": "core_transaction_5BIJT5QH8Qm2n1x~0",
  "status": "processing",
  "rejection": {
    "reason": "internal_error",
    "details": "Funding object rejected due to an internal error."
  },
  "created_at": "2026-09-17T11:01:36Z",
  "updated_at": "2026-09-17T11:05:00Z"
}

Changes