Expense 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 expense, this value should be "Expense".

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 Income group.It should be retrieved from the List of Ledger Groups API.

expense_type

integer

required

ID referencing the type of expense (fetched from the Ledger Detail API).

is_gst_applicable

boolean

required

Indicates whether GST is applicable to this income. 1 means Yes, 0 means No.

gst_tax_id

integer

optional

Required when GST is applicable. Refers to the applicable GST tax rate, selecte from a gst rates api which in common apis list.

gst_cess_rate

integer

optional

Additional GST Cess rate (if any) applicable to this expense, you can get it from cess rate api.

hsn_sac_code

string

optional

HSN (for goods) or SAC (for services) code that classifies the type of supply under GST norms.

description

string

optional

Optional field to describe the purpose or nature of the expense.

opening_balance_details

object

optional

opening_balance_dr_cr

integer

optional

Initial balance of the income ledger.

opening_balance

integer

optional

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

Example

{
    "action": "Expense",
    "name": "expense",
    "group_id": "7",
    "expense_type": 2,
    "is_gst_applicable": 1,
    "gst_tax_id": 7,
    "gst_cess_rate": 5,
    "hsn_sac_code": "6616",
    "description": "test",
    "opening_balance_details": {
        "opening_balance_dr_cr": 1,
        "opening_balance": 100
    }
}

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": "Expense",
    "name": "expense",
    "group_id": "7",
    "expense_type": 2,
    "is_gst_applicable": 1,
    "gst_tax_id": 7,
    "gst_cess_rate": 5,
    "hsn_sac_code": "6616",
    "description": "test",
    "opening_balance_details": {
        "opening_balance_dr_cr": 1,
        "opening_balance": 100
    }
}'

Responses

🟢200Expense 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 Income group.

model_type

string

required

Defines the type of model the ledger belongs to.

model_id

integer

required

The identifier linking the ledger to a specific data model.

company_id

integer

required

The ID of the company associated with the ledger.

ledgers_data

object

required

model

object

required

opening_balance

number

required

The starting financial balance for the ledger.

opening_balance_dr_cr

integer

required

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

via_api

boolean

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": 7,
        "name": "expense",
        "group_id": "7",
        "model_type": "App\\Models\\Master\\Expense",
        "model_id": 7,
        "company_id": 1,
        "ledgers_data": {
            "Expense": {
                "opening_balance": null,
                "opening_balance_dr_cr": null,
                "is_gst_applicable": 1,
                "gst_tax_id": 7,
                "gst_cess_rate": 5,
                "hsn_sac_code": "6616",
                "description": "test"
            }
        },
        "model": {
            "id": 7,
            "expense_type": 2,
            "opening_balance": null,
            "opening_balance_dr_cr": null,
            "closing_balance": null,
            "closing_balance_dr_cr": null,
            "is_gst_applicable": 1,
            "gst_tax_id": 7,
            "gst_cess_rate": 5,
            "hsn_sac_code": "6616",
            "description": "test",
            "gst_tax_rate": 5,
            "gst_cess": null,
            "gst_tax": {
                "id": 7,
                "name": "5%",
                "tax_rate": 5,
                "company_id": null,
                "created_at": "2023-02-10T04:22:55.000000Z",
                "updated_at": "2023-02-10T04:22:55.000000Z"
            },
            "gst_gst_cess_rate": null,
            "via_api": 0,
            "created_at": "2025-04-04T07:19:21.000000Z",
            "updated_at": "2025-04-04T07:19:21.000000Z"
        },
        "opening_balance": null,
        "opening_balance_dr_cr": null,
        "via_api": false,
        "is_import": false,
        "updated_at": "2025-04-04T07:19:21.000000Z",
        "created_at": "2025-04-04T07:19:21.000000Z",
        "flag": "additional"
    },
    "success": true,
    "message": "Expense Created Successfully."
}