Secured Loan Ledger - HisabKitab

Request

Authorization

Add parameter in header

ApiKey

Example:

ApiKey: ********************

Body Params application/json

action

string

required

Specifies the type of ledger being created. For Secured Loan, this value should be "Secured Loan".

name

string

required

This field specifies the name of the ledger.

group_id

integer

required

The unique identifier of the ledger group under which this ledger will be created here is Secured Loan group.It should be retrieved from the List of Ledger Groups API.

secured_loan_type

integer

required

This field defines the loan type for a particular transaction. It can represent one of several predefined types To get these use ledger detail api.

loan_account_number

string

optional

The official account number assigned to the loan. Used for tracking repayments and financial reconciliation.

name_of_financier

string

optional

The name of the lender or institution providing the loan.

rate_of_annum

number

optional

The annual interest rate for the loan (e.g., 10%). This rate determines interest accrual over the loan term.

opening_balance_details

object

optional

opening_balance

number

optional

The initial loan balance at the time of account creation or migration.

opening_balance_dr_cr

integer

optional

Indicates whether the opening balance is a debit (1) or credit (2) entry.

Example

{
    "action": "Secured Loan",
    "name": "Jitudsfdf Prajapati",
    "group_id": "16",
    "secured_loan_type": "1",
    "loan_account_number": "12345678",
    "name_of_financier": "joan",
    "rate_of_annum": "10",
    "opening_balance_details": {
        "opening_balance": 100000,
        "opening_balance_dr_cr": 2
    }
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://app.hisabkitab.co/third-party/ledgers' \
--header 'Content-Type: application/json' \
--header 'ApiKey;' \
--data-raw '{
    "action": "Secured Loan",
    "name": "Jitudsfdf Prajapati",
    "group_id": "16",
    "secured_loan_type": "1",
    "loan_account_number": "12345678",
    "name_of_financier": "joan",
    "rate_of_annum": "10",
    "opening_balance_details": {
        "opening_balance": 100000,
        "opening_balance_dr_cr": 2
    }
}'

Responses

🟢200Secured Loan Ledger

application/json

Body

data

object

required

id

integer

required

A unique identifier for the ledger.

name

string

required

This field specifies the name of the ledger.

group_id

integer

required

The unique identifier of the ledger group under which this ledger will be created here is Secured Loan group.It should be retrieved from the List of Ledger Groups API.

model_type

string

required

Defines the type of model the bank belongs to.

model_id

integer

required

The identifier linking the bank to a specific data model.

company_id

integer

required

The ID of the company associated with the ledger.

ledgers_data

object

required

opening_balance

number

required

The initial loan balance at the time of account creation or migration.

opening_balance_dr_cr

integer

required

Indicates whether the opening balance is a debit (1) or credit (2) entry.

via_api

integer

required

is_import

boolean

required

created_at

string

required

The date and time indicating when the record was initially created in the system.

updated_at

string

required

The date and time indicating when the record was last modified or updated in the system.

flag

string

required

success

boolean

required

message

string

required

Example

{
    "data": {
        "id": 16,
        "name": "Jitudsfdf Prajapati",
        "group_id": "16",
        "model_type": "App\\Models\\Master\\SecuredLoan",
        "model_id": 16,
        "company_id": 1,
        "ledgers_data": {
            "SecuredLoan": {
                "loan_type": "1",
                "loan_account_number": "12345678",
                "rate_of_interest_per_annum": 10,
                "name_of_financier": "joan",
                "opening_balance": null,
                "opening_balance_dr_cr": null
            }
        },
        "opening_balance": null,
        "opening_balance_dr_cr": null,
        "via_api": 2,
        "is_import": false,
        "created_at": "2025-04-05T04:01:35.000000Z",
        "updated_at": "2025-04-05T04:01:35.000000Z",
        "flag": "addless"
    },
    "success": true,
    "message": "Secured Loan Created Successfully."
}