Transactions

Split transaction

Splits one transaction into lines, the same as “Split transaction” in the Finta app. Each line has its own amount, category, merchant, department and spread, and the lines’ signed amount_cents must add up exactly to the transaction’s. The transaction then has transaction_type: split, the Split category and status: approved, and GET /transactions/splits lists its lines.

A line’s merchant defaults to the transaction’s. Leave out a line’s department_id to give it the transaction’s department, or send null for none. Only lines in a category that can have a department, such as an expense, take one: an inherited department is dropped from any other line, and sending department_id for one is refused. Income and expense lines can be spread and can have their own accounting_date, which defaults to the transaction’s accounting date; other lines are always booked on the transaction’s date.

Only a transaction in USD that isn’t split already can be split. A transaction that paid an invoice, a matched transfer, a spread transaction (spread its lines instead), a capitalized purchase, and one in a department split or a payroll split are refused, because splitting would double count or undo them. Requires Transactions: Manage.

POST

transactions

{id}

split

Split transaction

curl --request POST \
  --url https://app.finta.com/api/v1/transactions/{id}/split \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "lines": [
    {
      "amount_cents": -60000,
      "category_id": "cat_v5e6f7g8h9i0j1",
      "merchant": "Figma",
      "spread": 12
    },
    {
      "amount_cents": -40000,
      "category_id": "cat_k1l2m3n4o5p6q7",
      "department_id": null
    }
  ]
}
'

import requests

url = "https://app.finta.com/api/v1/transactions/{id}/split"

payload = { "lines": [
        {
            "amount_cents": -60000,
            "category_id": "cat_v5e6f7g8h9i0j1",
            "merchant": "Figma",
            "spread": 12
        },
        {
            "amount_cents": -40000,
            "category_id": "cat_k1l2m3n4o5p6q7",
            "department_id": None
        }
    ] }
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({
    lines: [
      {
        amount_cents: -60000,
        category_id: 'cat_v5e6f7g8h9i0j1',
        merchant: 'Figma',
        spread: 12
      },
      {amount_cents: -40000, category_id: 'cat_k1l2m3n4o5p6q7', department_id: null}
    ]
  })
};

fetch('https://app.finta.com/api/v1/transactions/{id}/split', 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/transactions/{id}/split",
  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([
    'lines' => [
        [
                'amount_cents' => -60000,
                'category_id' => 'cat_v5e6f7g8h9i0j1',
                'merchant' => 'Figma',
                'spread' => 12
        ],
        [
                'amount_cents' => -40000,
                'category_id' => 'cat_k1l2m3n4o5p6q7',
                'department_id' => null
        ]
    ]
  ]),
  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/transactions/{id}/split"

	payload := strings.NewReader("{\n  \"lines\": [\n    {\n      \"amount_cents\": -60000,\n      \"category_id\": \"cat_v5e6f7g8h9i0j1\",\n      \"merchant\": \"Figma\",\n      \"spread\": 12\n    },\n    {\n      \"amount_cents\": -40000,\n      \"category_id\": \"cat_k1l2m3n4o5p6q7\",\n      \"department_id\": null\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/transactions/{id}/split")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"lines\": [\n    {\n      \"amount_cents\": -60000,\n      \"category_id\": \"cat_v5e6f7g8h9i0j1\",\n      \"merchant\": \"Figma\",\n      \"spread\": 12\n    },\n    {\n      \"amount_cents\": -40000,\n      \"category_id\": \"cat_k1l2m3n4o5p6q7\",\n      \"department_id\": null\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.finta.com/api/v1/transactions/{id}/split")

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  \"lines\": [\n    {\n      \"amount_cents\": -60000,\n      \"category_id\": \"cat_v5e6f7g8h9i0j1\",\n      \"merchant\": \"Figma\",\n      \"spread\": 12\n    },\n    {\n      \"amount_cents\": -40000,\n      \"category_id\": \"cat_k1l2m3n4o5p6q7\",\n      \"department_id\": null\n    }\n  ]\n}"

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

{
  "object": "list",
  "url": "/api/v1/transactions/splits",
  "has_more": false,
  "next_cursor": null,
  "data": [
    {
      "object": "transaction_split",
      "transaction_id": "txn_a1b2c3d4e5f6g7",
      "date": "2026-02-15",
      "accounting_date": "2026-02-15",
      "amount_cents": -60000,
      "currency": "USD",
      "merchant": "Figma",
      "category_id": "cat_v5e6f7g8h9i0j1",
      "category_name": "Software",
      "department_id": "dept_d4e5f6g7h8i9j0",
      "department_name": "Engineering",
      "spread": 12
    },
    {
      "object": "transaction_split",
      "transaction_id": "txn_a1b2c3d4e5f6g7",
      "date": "2026-02-15",
      "accounting_date": "2026-02-15",
      "amount_cents": -40000,
      "currency": "USD",
      "merchant": "AWS",
      "category_id": "cat_k1l2m3n4o5p6q7",
      "category_name": "Hosting",
      "department_id": null,
      "department_name": null,
      "spread": null
    }
  ]
}

Authorizations

Authorization

string

header

required

API key prefixed with finta_

Path Parameters

string

required

Transaction ID with txn_ prefix.

Pattern: ^txn_

Body

application/json

lines

object[]

required

The lines, which the response lists in this order. Their signed amount_cents must add up exactly to the transaction's.

Required array length: 2 - 100 elements

Show child attributes

Response

The split's lines, in the order they were sent: the same list GET /transactions/splits returns for this transaction.

object

enum<string>

required

Available options:

list

url

string

required

Example:

"/api/v1/transactions/splits"

has_more

boolean

required

Always false. Every line is returned.

next_cursor

string | null

required

Always null.

data

object[]

required

Show child attributes

Split transaction

curl --request POST \
  --url https://app.finta.com/api/v1/transactions/{id}/split \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "lines": [
    {
      "amount_cents": -60000,
      "category_id": "cat_v5e6f7g8h9i0j1",
      "merchant": "Figma",
      "spread": 12
    },
    {
      "amount_cents": -40000,
      "category_id": "cat_k1l2m3n4o5p6q7",
      "department_id": null
    }
  ]
}
'

import requests

url = "https://app.finta.com/api/v1/transactions/{id}/split"

payload = { "lines": [
        {
            "amount_cents": -60000,
            "category_id": "cat_v5e6f7g8h9i0j1",
            "merchant": "Figma",
            "spread": 12
        },
        {
            "amount_cents": -40000,
            "category_id": "cat_k1l2m3n4o5p6q7",
            "department_id": None
        }
    ] }
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({
    lines: [
      {
        amount_cents: -60000,
        category_id: 'cat_v5e6f7g8h9i0j1',
        merchant: 'Figma',
        spread: 12
      },
      {amount_cents: -40000, category_id: 'cat_k1l2m3n4o5p6q7', department_id: null}
    ]
  })
};

fetch('https://app.finta.com/api/v1/transactions/{id}/split', 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/transactions/{id}/split",
  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([
    'lines' => [
        [
                'amount_cents' => -60000,
                'category_id' => 'cat_v5e6f7g8h9i0j1',
                'merchant' => 'Figma',
                'spread' => 12
        ],
        [
                'amount_cents' => -40000,
                'category_id' => 'cat_k1l2m3n4o5p6q7',
                'department_id' => null
        ]
    ]
  ]),
  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/transactions/{id}/split"

	payload := strings.NewReader("{\n  \"lines\": [\n    {\n      \"amount_cents\": -60000,\n      \"category_id\": \"cat_v5e6f7g8h9i0j1\",\n      \"merchant\": \"Figma\",\n      \"spread\": 12\n    },\n    {\n      \"amount_cents\": -40000,\n      \"category_id\": \"cat_k1l2m3n4o5p6q7\",\n      \"department_id\": null\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/transactions/{id}/split")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"lines\": [\n    {\n      \"amount_cents\": -60000,\n      \"category_id\": \"cat_v5e6f7g8h9i0j1\",\n      \"merchant\": \"Figma\",\n      \"spread\": 12\n    },\n    {\n      \"amount_cents\": -40000,\n      \"category_id\": \"cat_k1l2m3n4o5p6q7\",\n      \"department_id\": null\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.finta.com/api/v1/transactions/{id}/split")

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  \"lines\": [\n    {\n      \"amount_cents\": -60000,\n      \"category_id\": \"cat_v5e6f7g8h9i0j1\",\n      \"merchant\": \"Figma\",\n      \"spread\": 12\n    },\n    {\n      \"amount_cents\": -40000,\n      \"category_id\": \"cat_k1l2m3n4o5p6q7\",\n      \"department_id\": null\n    }\n  ]\n}"

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

{
  "object": "list",
  "url": "/api/v1/transactions/splits",
  "has_more": false,
  "next_cursor": null,
  "data": [
    {
      "object": "transaction_split",
      "transaction_id": "txn_a1b2c3d4e5f6g7",
      "date": "2026-02-15",
      "accounting_date": "2026-02-15",
      "amount_cents": -60000,
      "currency": "USD",
      "merchant": "Figma",
      "category_id": "cat_v5e6f7g8h9i0j1",
      "category_name": "Software",
      "department_id": "dept_d4e5f6g7h8i9j0",
      "department_name": "Engineering",
      "spread": 12
    },
    {
      "object": "transaction_split",
      "transaction_id": "txn_a1b2c3d4e5f6g7",
      "date": "2026-02-15",
      "accounting_date": "2026-02-15",
      "amount_cents": -40000,
      "currency": "USD",
      "merchant": "AWS",
      "category_id": "cat_k1l2m3n4o5p6q7",
      "category_name": "Hosting",
      "department_id": null,
      "department_name": null,
      "spread": null
    }
  ]
}

API Reference

Taxes

Files

Company

Plans & billing

Team

Categories

Rules

Departments

Integrations

Aggregations

Transactions

Forms

Journal Entries

Invoices

Parties

Reports

Feedback

Tax Credits

Split transaction

Authorizations

Path Parameters

Body

Response