Journal Entries

Create journal entry batch

Posts two or more journal entries as one batch, with a memo saying what the batch is for. On each date, total debits must equal total credits. Every entry is checked before anything is saved, and either the whole batch is saved or none of it is. The entries show in reports like any other journal entries, with source_type manual_batch; no transaction is created. Requires Transactions: Manage.

Errors name the entry they’re about, such as entries[3].category_id. A batch whose dates don’t balance returns 400 journal_entries_unbalanced, naming each date with its debit and credit totals. Only an entry in an expense category can have a department. An entry in a reconciled account can’t be dated on or before that account’s last reconciliation: 409 journal_entries_reconciled, naming the entry.

POST

journal_entry_batches

curl --request POST \
  --url https://app.finta.com/api/v1/journal_entry_batches \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "memo": "Accrue the last week of October payroll, paid November 3.",
  "entries": [
    {
      "date": "2026-10-31",
      "category_id": "cat_o5p6q7r8s9t0u1",
      "type": "debit",
      "amount_cents": 1800000,
      "merchant": "Gusto"
    },
    {
      "date": "2026-10-31",
      "category_id": "cat_j6k7l8m9n0o1p2",
      "type": "credit",
      "amount_cents": 1800000,
      "merchant": "Gusto"
    }
  ]
}
'

import requests

url = "https://app.finta.com/api/v1/journal_entry_batches"

payload = {
    "memo": "Accrue the last week of October payroll, paid November 3.",
    "entries": [
        {
            "date": "2026-10-31",
            "category_id": "cat_o5p6q7r8s9t0u1",
            "type": "debit",
            "amount_cents": 1800000,
            "merchant": "Gusto"
        },
        {
            "date": "2026-10-31",
            "category_id": "cat_j6k7l8m9n0o1p2",
            "type": "credit",
            "amount_cents": 1800000,
            "merchant": "Gusto"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    memo: 'Accrue the last week of October payroll, paid November 3.',
    entries: [
      {
        date: '2026-10-31',
        category_id: 'cat_o5p6q7r8s9t0u1',
        type: 'debit',
        amount_cents: 1800000,
        merchant: 'Gusto'
      },
      {
        date: '2026-10-31',
        category_id: 'cat_j6k7l8m9n0o1p2',
        type: 'credit',
        amount_cents: 1800000,
        merchant: 'Gusto'
      }
    ]
  })
};

fetch('https://app.finta.com/api/v1/journal_entry_batches', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.finta.com/api/v1/journal_entry_batches",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'memo' => 'Accrue the last week of October payroll, paid November 3.',
    'entries' => [
        [
                'date' => '2026-10-31',
                'category_id' => 'cat_o5p6q7r8s9t0u1',
                'type' => 'debit',
                'amount_cents' => 1800000,
                'merchant' => 'Gusto'
        ],
        [
                'date' => '2026-10-31',
                'category_id' => 'cat_j6k7l8m9n0o1p2',
                'type' => 'credit',
                'amount_cents' => 1800000,
                'merchant' => 'Gusto'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.finta.com/api/v1/journal_entry_batches"

	payload := strings.NewReader("{\n  \"memo\": \"Accrue the last week of October payroll, paid November 3.\",\n  \"entries\": [\n    {\n      \"date\": \"2026-10-31\",\n      \"category_id\": \"cat_o5p6q7r8s9t0u1\",\n      \"type\": \"debit\",\n      \"amount_cents\": 1800000,\n      \"merchant\": \"Gusto\"\n    },\n    {\n      \"date\": \"2026-10-31\",\n      \"category_id\": \"cat_j6k7l8m9n0o1p2\",\n      \"type\": \"credit\",\n      \"amount_cents\": 1800000,\n      \"merchant\": \"Gusto\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.finta.com/api/v1/journal_entry_batches")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"memo\": \"Accrue the last week of October payroll, paid November 3.\",\n  \"entries\": [\n    {\n      \"date\": \"2026-10-31\",\n      \"category_id\": \"cat_o5p6q7r8s9t0u1\",\n      \"type\": \"debit\",\n      \"amount_cents\": 1800000,\n      \"merchant\": \"Gusto\"\n    },\n    {\n      \"date\": \"2026-10-31\",\n      \"category_id\": \"cat_j6k7l8m9n0o1p2\",\n      \"type\": \"credit\",\n      \"amount_cents\": 1800000,\n      \"merchant\": \"Gusto\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.finta.com/api/v1/journal_entry_batches")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"memo\": \"Accrue the last week of October payroll, paid November 3.\",\n  \"entries\": [\n    {\n      \"date\": \"2026-10-31\",\n      \"category_id\": \"cat_o5p6q7r8s9t0u1\",\n      \"type\": \"debit\",\n      \"amount_cents\": 1800000,\n      \"merchant\": \"Gusto\"\n    },\n    {\n      \"date\": \"2026-10-31\",\n      \"category_id\": \"cat_j6k7l8m9n0o1p2\",\n      \"type\": \"credit\",\n      \"amount_cents\": 1800000,\n      \"merchant\": \"Gusto\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "jmb_a1b2c3d4e5f6g7",
  "object": "journal_entry_batch",
  "memo": "Accrue the last week of October payroll, paid November 3.",
  "source": "ui",
  "entry_count": 2,
  "total_debit_cents": 1800000,
  "total_credit_cents": 1800000,
  "start_date": "2026-10-31",
  "end_date": "2026-10-31",
  "created": 1793404800,
  "entries": [
    {
      "id": "je_abc123",
      "object": "journal_entry",
      "date": "2026-01-15",
      "amount_cents": 49900,
      "type": "debit",
      "currency": "USD",
      "transaction_id": "txn_a1b2c3d4e5f6g7",
      "department_id": "dept_b2c3d4e5f6g7h8",
      "created": 1771113600,
      "merchant": "<string>",
      "name": "<string>",
      "category_id": "cat_o5p6q7r8s9t0u1",
      "category_name": "Software",
      "source_type": "transaction"
    }
  ]
}

Authorizations

Authorization

string

header

required

An API key prefixed with finta_, or the access token from a Finta CLI browser login (finta login), prefixed with finta_oat_. A CLI login's access token lasts one hour and the CLI renews it itself.

Body

application/json

memo

string

required

What the batch is for and why.

Required string length: 1 - 1000

entries

object[]

required

Required array length: 2 - 100 elements

Show child attributes

Response

The created batch and its entries, in the order they were sent

string

required

Unique identifier with jmb_ prefix.

Example:

"jmb_a1b2c3d4e5f6g7"

object

enum<string>

required

Available options:

journal_entry_batch

memo

string | null

required

What the batch is for. Null for batches made in Finta before memos existed.

Example:

"Accrue the last week of October payroll, paid November 3."

source

enum<string>

required

Where the batch was made. Any batch can be deleted through the API, whatever its source.

Available options:

ui,

api,

mcp

entry_count

integer

required

Example:

2

total_debit_cents

integer

required

Total of the batch's debits, in cents.

Example:

1800000

total_credit_cents

integer

required

Total of the batch's credits, in cents.

Example:

1800000

start_date

string<date> | null

required

The earliest entry date. Null for a batch without entries.

Example:

"2026-10-31"

end_date

string<date> | null

required

The latest entry date. Null for a batch without entries.

Example:

"2026-10-31"

created

integer

required

When the batch was created, as a Unix timestamp.

Example:

1793404800

entries

object[]

required

The batch's journal entries, in the order they were sent.

Show child attributes

Create journal entry batch

curl --request POST \
  --url https://app.finta.com/api/v1/journal_entry_batches \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "memo": "Accrue the last week of October payroll, paid November 3.",
  "entries": [
    {
      "date": "2026-10-31",
      "category_id": "cat_o5p6q7r8s9t0u1",
      "type": "debit",
      "amount_cents": 1800000,
      "merchant": "Gusto"
    },
    {
      "date": "2026-10-31",
      "category_id": "cat_j6k7l8m9n0o1p2",
      "type": "credit",
      "amount_cents": 1800000,
      "merchant": "Gusto"
    }
  ]
}
'

import requests

url = "https://app.finta.com/api/v1/journal_entry_batches"

payload = {
    "memo": "Accrue the last week of October payroll, paid November 3.",
    "entries": [
        {
            "date": "2026-10-31",
            "category_id": "cat_o5p6q7r8s9t0u1",
            "type": "debit",
            "amount_cents": 1800000,
            "merchant": "Gusto"
        },
        {
            "date": "2026-10-31",
            "category_id": "cat_j6k7l8m9n0o1p2",
            "type": "credit",
            "amount_cents": 1800000,
            "merchant": "Gusto"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    memo: 'Accrue the last week of October payroll, paid November 3.',
    entries: [
      {
        date: '2026-10-31',
        category_id: 'cat_o5p6q7r8s9t0u1',
        type: 'debit',
        amount_cents: 1800000,
        merchant: 'Gusto'
      },
      {
        date: '2026-10-31',
        category_id: 'cat_j6k7l8m9n0o1p2',
        type: 'credit',
        amount_cents: 1800000,
        merchant: 'Gusto'
      }
    ]
  })
};

fetch('https://app.finta.com/api/v1/journal_entry_batches', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.finta.com/api/v1/journal_entry_batches",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'memo' => 'Accrue the last week of October payroll, paid November 3.',
    'entries' => [
        [
                'date' => '2026-10-31',
                'category_id' => 'cat_o5p6q7r8s9t0u1',
                'type' => 'debit',
                'amount_cents' => 1800000,
                'merchant' => 'Gusto'
        ],
        [
                'date' => '2026-10-31',
                'category_id' => 'cat_j6k7l8m9n0o1p2',
                'type' => 'credit',
                'amount_cents' => 1800000,
                'merchant' => 'Gusto'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.finta.com/api/v1/journal_entry_batches"

	payload := strings.NewReader("{\n  \"memo\": \"Accrue the last week of October payroll, paid November 3.\",\n  \"entries\": [\n    {\n      \"date\": \"2026-10-31\",\n      \"category_id\": \"cat_o5p6q7r8s9t0u1\",\n      \"type\": \"debit\",\n      \"amount_cents\": 1800000,\n      \"merchant\": \"Gusto\"\n    },\n    {\n      \"date\": \"2026-10-31\",\n      \"category_id\": \"cat_j6k7l8m9n0o1p2\",\n      \"type\": \"credit\",\n      \"amount_cents\": 1800000,\n      \"merchant\": \"Gusto\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.finta.com/api/v1/journal_entry_batches")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"memo\": \"Accrue the last week of October payroll, paid November 3.\",\n  \"entries\": [\n    {\n      \"date\": \"2026-10-31\",\n      \"category_id\": \"cat_o5p6q7r8s9t0u1\",\n      \"type\": \"debit\",\n      \"amount_cents\": 1800000,\n      \"merchant\": \"Gusto\"\n    },\n    {\n      \"date\": \"2026-10-31\",\n      \"category_id\": \"cat_j6k7l8m9n0o1p2\",\n      \"type\": \"credit\",\n      \"amount_cents\": 1800000,\n      \"merchant\": \"Gusto\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.finta.com/api/v1/journal_entry_batches")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"memo\": \"Accrue the last week of October payroll, paid November 3.\",\n  \"entries\": [\n    {\n      \"date\": \"2026-10-31\",\n      \"category_id\": \"cat_o5p6q7r8s9t0u1\",\n      \"type\": \"debit\",\n      \"amount_cents\": 1800000,\n      \"merchant\": \"Gusto\"\n    },\n    {\n      \"date\": \"2026-10-31\",\n      \"category_id\": \"cat_j6k7l8m9n0o1p2\",\n      \"type\": \"credit\",\n      \"amount_cents\": 1800000,\n      \"merchant\": \"Gusto\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "jmb_a1b2c3d4e5f6g7",
  "object": "journal_entry_batch",
  "memo": "Accrue the last week of October payroll, paid November 3.",
  "source": "ui",
  "entry_count": 2,
  "total_debit_cents": 1800000,
  "total_credit_cents": 1800000,
  "start_date": "2026-10-31",
  "end_date": "2026-10-31",
  "created": 1793404800,
  "entries": [
    {
      "id": "je_abc123",
      "object": "journal_entry",
      "date": "2026-01-15",
      "amount_cents": 49900,
      "type": "debit",
      "currency": "USD",
      "transaction_id": "txn_a1b2c3d4e5f6g7",
      "department_id": "dept_b2c3d4e5f6g7h8",
      "created": 1771113600,
      "merchant": "<string>",
      "name": "<string>",
      "category_id": "cat_o5p6q7r8s9t0u1",
      "category_name": "Software",
      "source_type": "transaction"
    }
  ]
}

API Reference

Onboarding

Sheets

Taxes

Files

Company

Plans & billing

Team

Categories

Rules

Tags

Departments

Integrations

Inbox

Aggregations

Transactions

Forms

Reconciliation

Journal Entries

Invoices

Parties

Metrics

Reports

Feedback

Tax Credits

Create journal entry batch

Authorizations

Body

Response