curl --request PATCH \
--url https://api.breezing.io/v1/journals/{id} \
--header 'Content-Type: application/json' \
--data '
{
"date": "2026-03-31",
"reference": "ACCR-2026-03",
"description": "Accrue March hosting",
"reversalDate": "2026-04-01",
"lines": [
{
"code": "6500",
"debit": "75.00",
"credit": "75.00",
"description": "<string>",
"tax": "<string>",
"taxAmount": "8.03",
"taxOverride": true,
"contactId": 42,
"xeroTrackingCategory": "<string>",
"qboClass": "<string>"
}
],
"post": true
}
'import requests
url = "https://api.breezing.io/v1/journals/{id}"
payload = {
"date": "2026-03-31",
"reference": "ACCR-2026-03",
"description": "Accrue March hosting",
"reversalDate": "2026-04-01",
"lines": [
{
"code": "6500",
"debit": "75.00",
"credit": "75.00",
"description": "<string>",
"tax": "<string>",
"taxAmount": "8.03",
"taxOverride": True,
"contactId": 42,
"xeroTrackingCategory": "<string>",
"qboClass": "<string>"
}
],
"post": True
}
headers = {"Content-Type": "application/json"}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
date: '2026-03-31',
reference: 'ACCR-2026-03',
description: 'Accrue March hosting',
reversalDate: '2026-04-01',
lines: [
{
code: '6500',
debit: '75.00',
credit: '75.00',
description: '<string>',
tax: '<string>',
taxAmount: '8.03',
taxOverride: true,
contactId: 42,
xeroTrackingCategory: '<string>',
qboClass: '<string>'
}
],
post: true
})
};
fetch('https://api.breezing.io/v1/journals/{id}', 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://api.breezing.io/v1/journals/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'date' => '2026-03-31',
'reference' => 'ACCR-2026-03',
'description' => 'Accrue March hosting',
'reversalDate' => '2026-04-01',
'lines' => [
[
'code' => '6500',
'debit' => '75.00',
'credit' => '75.00',
'description' => '<string>',
'tax' => '<string>',
'taxAmount' => '8.03',
'taxOverride' => true,
'contactId' => 42,
'xeroTrackingCategory' => '<string>',
'qboClass' => '<string>'
]
],
'post' => true
]),
CURLOPT_HTTPHEADER => [
"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://api.breezing.io/v1/journals/{id}"
payload := strings.NewReader("{\n \"date\": \"2026-03-31\",\n \"reference\": \"ACCR-2026-03\",\n \"description\": \"Accrue March hosting\",\n \"reversalDate\": \"2026-04-01\",\n \"lines\": [\n {\n \"code\": \"6500\",\n \"debit\": \"75.00\",\n \"credit\": \"75.00\",\n \"description\": \"<string>\",\n \"tax\": \"<string>\",\n \"taxAmount\": \"8.03\",\n \"taxOverride\": true,\n \"contactId\": 42,\n \"xeroTrackingCategory\": \"<string>\",\n \"qboClass\": \"<string>\"\n }\n ],\n \"post\": true\n}")
req, _ := http.NewRequest("PATCH", url, payload)
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.patch("https://api.breezing.io/v1/journals/{id}")
.header("Content-Type", "application/json")
.body("{\n \"date\": \"2026-03-31\",\n \"reference\": \"ACCR-2026-03\",\n \"description\": \"Accrue March hosting\",\n \"reversalDate\": \"2026-04-01\",\n \"lines\": [\n {\n \"code\": \"6500\",\n \"debit\": \"75.00\",\n \"credit\": \"75.00\",\n \"description\": \"<string>\",\n \"tax\": \"<string>\",\n \"taxAmount\": \"8.03\",\n \"taxOverride\": true,\n \"contactId\": 42,\n \"xeroTrackingCategory\": \"<string>\",\n \"qboClass\": \"<string>\"\n }\n ],\n \"post\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.breezing.io/v1/journals/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"date\": \"2026-03-31\",\n \"reference\": \"ACCR-2026-03\",\n \"description\": \"Accrue March hosting\",\n \"reversalDate\": \"2026-04-01\",\n \"lines\": [\n {\n \"code\": \"6500\",\n \"debit\": \"75.00\",\n \"credit\": \"75.00\",\n \"description\": \"<string>\",\n \"tax\": \"<string>\",\n \"taxAmount\": \"8.03\",\n \"taxOverride\": true,\n \"contactId\": 42,\n \"xeroTrackingCategory\": \"<string>\",\n \"qboClass\": \"<string>\"\n }\n ],\n \"post\": true\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"id": 123,
"kind": "manual",
"status": "<string>",
"number": 123,
"numberLabel": "MJ-0007",
"date": "2026-03-31",
"reversalDate": "2026-04-01",
"amountsAre": "noTax",
"reference": "<string>",
"description": "<string>",
"lineCount": 123,
"totalDebit": "<string>",
"totalCredit": "<string>",
"balanced": true,
"attachmentCount": 123,
"replacesId": 123,
"postedAt": 123,
"voidedAt": 123,
"xeroPublishState": "none",
"qboPublishState": "none",
"createdAt": 123,
"updatedAt": 123
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}Update Journal API
Update a manual journal in Breezing. Drafts are edited in place, and posted journals get a new version that keeps the audit trail.
curl --request PATCH \
--url https://api.breezing.io/v1/journals/{id} \
--header 'Content-Type: application/json' \
--data '
{
"date": "2026-03-31",
"reference": "ACCR-2026-03",
"description": "Accrue March hosting",
"reversalDate": "2026-04-01",
"lines": [
{
"code": "6500",
"debit": "75.00",
"credit": "75.00",
"description": "<string>",
"tax": "<string>",
"taxAmount": "8.03",
"taxOverride": true,
"contactId": 42,
"xeroTrackingCategory": "<string>",
"qboClass": "<string>"
}
],
"post": true
}
'import requests
url = "https://api.breezing.io/v1/journals/{id}"
payload = {
"date": "2026-03-31",
"reference": "ACCR-2026-03",
"description": "Accrue March hosting",
"reversalDate": "2026-04-01",
"lines": [
{
"code": "6500",
"debit": "75.00",
"credit": "75.00",
"description": "<string>",
"tax": "<string>",
"taxAmount": "8.03",
"taxOverride": True,
"contactId": 42,
"xeroTrackingCategory": "<string>",
"qboClass": "<string>"
}
],
"post": True
}
headers = {"Content-Type": "application/json"}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
date: '2026-03-31',
reference: 'ACCR-2026-03',
description: 'Accrue March hosting',
reversalDate: '2026-04-01',
lines: [
{
code: '6500',
debit: '75.00',
credit: '75.00',
description: '<string>',
tax: '<string>',
taxAmount: '8.03',
taxOverride: true,
contactId: 42,
xeroTrackingCategory: '<string>',
qboClass: '<string>'
}
],
post: true
})
};
fetch('https://api.breezing.io/v1/journals/{id}', 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://api.breezing.io/v1/journals/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'date' => '2026-03-31',
'reference' => 'ACCR-2026-03',
'description' => 'Accrue March hosting',
'reversalDate' => '2026-04-01',
'lines' => [
[
'code' => '6500',
'debit' => '75.00',
'credit' => '75.00',
'description' => '<string>',
'tax' => '<string>',
'taxAmount' => '8.03',
'taxOverride' => true,
'contactId' => 42,
'xeroTrackingCategory' => '<string>',
'qboClass' => '<string>'
]
],
'post' => true
]),
CURLOPT_HTTPHEADER => [
"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://api.breezing.io/v1/journals/{id}"
payload := strings.NewReader("{\n \"date\": \"2026-03-31\",\n \"reference\": \"ACCR-2026-03\",\n \"description\": \"Accrue March hosting\",\n \"reversalDate\": \"2026-04-01\",\n \"lines\": [\n {\n \"code\": \"6500\",\n \"debit\": \"75.00\",\n \"credit\": \"75.00\",\n \"description\": \"<string>\",\n \"tax\": \"<string>\",\n \"taxAmount\": \"8.03\",\n \"taxOverride\": true,\n \"contactId\": 42,\n \"xeroTrackingCategory\": \"<string>\",\n \"qboClass\": \"<string>\"\n }\n ],\n \"post\": true\n}")
req, _ := http.NewRequest("PATCH", url, payload)
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.patch("https://api.breezing.io/v1/journals/{id}")
.header("Content-Type", "application/json")
.body("{\n \"date\": \"2026-03-31\",\n \"reference\": \"ACCR-2026-03\",\n \"description\": \"Accrue March hosting\",\n \"reversalDate\": \"2026-04-01\",\n \"lines\": [\n {\n \"code\": \"6500\",\n \"debit\": \"75.00\",\n \"credit\": \"75.00\",\n \"description\": \"<string>\",\n \"tax\": \"<string>\",\n \"taxAmount\": \"8.03\",\n \"taxOverride\": true,\n \"contactId\": 42,\n \"xeroTrackingCategory\": \"<string>\",\n \"qboClass\": \"<string>\"\n }\n ],\n \"post\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.breezing.io/v1/journals/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"date\": \"2026-03-31\",\n \"reference\": \"ACCR-2026-03\",\n \"description\": \"Accrue March hosting\",\n \"reversalDate\": \"2026-04-01\",\n \"lines\": [\n {\n \"code\": \"6500\",\n \"debit\": \"75.00\",\n \"credit\": \"75.00\",\n \"description\": \"<string>\",\n \"tax\": \"<string>\",\n \"taxAmount\": \"8.03\",\n \"taxOverride\": true,\n \"contactId\": 42,\n \"xeroTrackingCategory\": \"<string>\",\n \"qboClass\": \"<string>\"\n }\n ],\n \"post\": true\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"id": 123,
"kind": "manual",
"status": "<string>",
"number": 123,
"numberLabel": "MJ-0007",
"date": "2026-03-31",
"reversalDate": "2026-04-01",
"amountsAre": "noTax",
"reference": "<string>",
"description": "<string>",
"lineCount": 123,
"totalDebit": "<string>",
"totalCredit": "<string>",
"balanced": true,
"attachmentCount": 123,
"replacesId": 123,
"postedAt": 123,
"voidedAt": 123,
"xeroPublishState": "none",
"qboPublishState": "none",
"createdAt": 123,
"updatedAt": 123
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}Query Parameters
Body
Optional: the day the journal reverses itself, yyyy-MM-dd (UTC), after date. Once posted the journal is in the books on its date and again, with debits and credits swapped, on this day (an accrual booked at month end and released on the first of the next month). The reversal is part of this journal: voiding or editing the journal takes it along. null clears it.
10"2026-04-01"
How the amounts relate to the tax rates on the lines. "noTax" (default): nothing is calculated. "exclusive": for every line carrying a tax rate above 0, the VAT (amount x rate, rounded to 2 decimals) is booked ON TOP of the amount, on the same side, on the VAT account of the rate (its output VAT account for a revenue or other income account, its input VAT account otherwise). "inclusive": the VAT (amount x rate / (100 + rate)) is carved OUT of the amount. Debits and credits are compared INCLUDING the calculated VAT. Posting 400s when the rate has no VAT account on the side the line needs.
noTax, exclusive, inclusive The journal lines. To POST a journal needs two or more lines, each with an account and exactly one side, and total debits EQUAL to total credits exactly (calculated VAT included): Breezing never adds a balancing line. A draft may be incomplete.
200Show child attributes
Show child attributes