Ledger accounts

Overview

A general ledger (GL) account is a component of an accounting system that is used to record and categorize a company’s financial transactions. Some examples of common ledger accounts are:

• Expenses: office supplies, utilities, salaries, taxes, and so on,
• Income: sales and revenue, dividends, and so on,
• Assets: cash, inventory, and so on,
• Liabilities: accounts payable, debt, and so on.

Within an accounting system, each line item on an invoice is assigned a ledger account in order to properly categorize various expenses and income sources. In Monite, the ledger_account_id field of products and payable line items is used to assign ledger accounts to business objects. Additionally, the entity setting accounting.ledger_account_ids.payments specifies the ledger account for all payment records.

Monite supports two types of ledger accounts:

• External ledger accounts (is_external = true): These are pulled from connected accounting systems and are read-only in Monite. They reflect the chart of accounts from your external accounting software.
• Internal ledger accounts (is_external = false): These are created and managed directly within Monite, giving you flexibility to define custom accounts for your business needs.

Products and payables pulled from the accounting system have the ledger_account_id pre-filled. However, when new products, payables, and payment records are created in Monite, the user must manually specify the ledger_account_id for those objects. This is required for Monite to be able to push those objects to the accounting system.

External ledger accounts

For external ledger accounts, the typical flow is as follows:

1. After connecting an entity to an accounting system, wait until the initial data pull is completed.
2. Call GET /ledger_accounts to get a list of an entity’s general ledgers pulled from the accounting system.
3. If an entity uses accounts payable:
   1. Get the line items of all payables and check if the line items have ledger_account_id.
   2. If any line item is missing a value for ledger_account_id, prompt the user to assign the appropriate ledger account.
4. If an entity uses accounts receivable:
   1. Get all products and check if they have ledger_account_id.
   2. If any product is missing a value for ledger_account_id, prompt the user to assign the appropriate ledger account.
5. If an entity uses payment records:
   1. Prompt the user to specify a ledger account for all payment records and store the account ID in the entity setting accounting.ledger_account_ids.payments.

Internal ledger accounts

You can create internal ledger accounts directly in Monite using the POST /ledger_accounts endpoint:

1
curl -X POST 'https://api.sandbox.monite.com/v1/ledger_accounts' \
2
     -H 'X-Monite-Version: 2024-05-25' \
3
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
4
     -H 'Authorization: Bearer ACCESS_TOKEN' \
5
     -H 'Content-Type: application/json' \
6
     -d '{
7
       "name": "Marketing Expenses",
8
       "nominal_code": "4500",
9
       "description": "Expenses related to marketing and advertising activities"
10
     }'

The successful 201 response returns the created ledger account:

1
{
2
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3
  "created_at": "2025-09-11T10:00:56.855Z",
4
  "updated_at": "2025-09-11T10:00:56.855Z",
5
  "currency": "EUR",
6
  "current_balance": 0,
7
  "description": "Expenses related to marketing and advertising activities",
8
  "is_bank_account": true,
9
  "is_external": false,
10
  "name": "Accounts Receivable",
11
  "nominal_code": "610",
12
  "status": "Active",
13
  "subtype": "Current",
14
  "type": "Asset"
15
}

Get ledger accounts

After connecting to an accounting system, Monite automatically retrieves a list of ledger accounts from there. Once the initial data synchronization has completed, you can call GET /ledger_accounts to get an entity’s ledger accounts that exist in the accounting system:

1
curl 'https://api.sandbox.monite.com/v1/ledger_accounts' \
2
  -H 'X-Monite-Version: 2024-05-25' \
3
  -H 'X-Monite-Entity-Id: ENTITY_ID' \
4
  -H 'Authorization: Bearer ACCESS_TOKEN'

Below is an example of ledger account details. Note down the IDs of the ledger accounts - these are the possible values of the ledger_account_id field in products and payable line items.

1
{
2
  "data": [
3
    {
4
      "id": "f5f85999-cc35-43e6-93ad-46d22907022a",
5
      "currency": "EUR",
6
      "current_balance": 0,
7
      "description": "Outstanding invoices the company has issued out to the client but has not yet received in cash at balance date.",
8
      "is_bank_account": false,
9
      "is_external": true, 
10
      "name": "Accounts Receivable",
11
      "nominal_code": "610",
12
      "status": "Active",
13
      "subtype": "Current",
14
      "type": "Asset"
15
    },
16
    {
17
      "id": "8ecb60fd-88fd-40e4-8bd9-5fa154435b78",
18
      "currency": "EUR",
19
      "current_balance": 0,
20
      "description": "Income from business activity",
21
      "is_bank_account": true,
22
      "name": "Sales",
23
      "nominal_code": "200",
24
      "type": "Income",
25
      "status": "Active",
26
      "subtype": "Revenue"
27
    },
28
    ...
29
  ],
30
  "next_pagination_token": null,
31
  "prev_pagination_token": null
32
}

The GET /ledger_accounts endpoint can also be used to retrieve internal ledger accounts by setting the query parameter is_external = false (e.g., GET /ledger_accounts?is_external=false).

To get information about a specific ledger account, call GET /ledger_accounts/{ledger_account_id}.

Edit a ledger account

To edit an existing ledger account, call PATCH /ledger_accounts/{ledger_account_id}.

Delete a ledger account

To delete a specific ledger account, call DELETE /ledger_accounts/{ledger_account_id}.

Assign ledger accounts to products and payable line items

Before payables can be pushed to an accounting system, each line item in all payables must have the ledger_account_id specified. Similarly, before Account Receivable invoices can be pushed to accounting, all products listed on invoices must have the ledger_account_id specified.

To specify an associated ledger account for a payable line item or a product, PATCH this object and provide the value for ledger_account_id. For example:

1
curl -X PATCH 'https://api.sandbox.monite.com/v1/products/51846...39d' \
2
     -H 'X-Monite-Version: 2024-05-25' \
3
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
4
     -H 'Authorization: Bearer ACCESS_TOKEN' \
5
     -H 'Content-Type: application/json' \
6
     -d '{
7
       "ledger_account_id": "f5f85999-cc35-43e6-93ad-46d22907022a"
8
     }'

Assign a ledger account to payment records

Before payment records can be pushed to an accounting system, the entity must specify the ledger account for these records. To do this, store the account ID in the the entity setting accounting.ledger_account_ids.payments:

1
curl -X PATCH 'https://api.sandbox.monite.com/v1/entities/daf8e...5e7' \
2
     -H 'X-Monite-Version: 2024-05-25' \
3
     -H 'Authorization: Bearer ACCESS_TOKEN' \
4
     -H 'Content-Type: application/json' \
5
     -d '{
6
       "accounting": {
7
         "ledger_account_ids": {
8
           "payments": "f5f85999-cc35-43e6-93ad-46d22907022a"
9
         }
10
       }
11
     }'

The specified ledger account will be used both for manually added payment records and for payments made via Monite payment page.