Batch Create Journals

curl --request POST \
  --url https://api.stackone.com/unified/accounting/companies/{id}/journals/batch \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'x-account-id: <x-account-id>' \
  --data '
{
  "items": [
    {
      "reference": "JRN-2024-001",
      "memo": "Monthly closing entries",
      "currency_code": {
        "value": "USD",
        "source_value": "USD"
      },
      "exchange_rate": 1,
      "transaction_date": "2024-03-20T10:00:00Z",
      "lines": [
        {
          "account_id": "acc_123456789",
          "description": "Payment for office supplies",
          "amount": 10010,
          "tax_rate_id": "tax_123456789",
          "tax_amount": 10010
        }
      ]
    }
  ]
}
'

{
  "statusCode": 202,
  "message": "Batch operation accepted",
  "timestamp": "2021-01-01T01:01:01.000Z",
  "errors": [
    [
      "Missing field: name"
    ],
    [],
    []
  ]
}

POST

unified

accounting

companies

{id}

journals

batch

Batch Create Journals

curl --request POST \
  --url https://api.stackone.com/unified/accounting/companies/{id}/journals/batch \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'x-account-id: <x-account-id>' \
  --data '
{
  "items": [
    {
      "reference": "JRN-2024-001",
      "memo": "Monthly closing entries",
      "currency_code": {
        "value": "USD",
        "source_value": "USD"
      },
      "exchange_rate": 1,
      "transaction_date": "2024-03-20T10:00:00Z",
      "lines": [
        {
          "account_id": "acc_123456789",
          "description": "Payment for office supplies",
          "amount": 10010,
          "tax_rate_id": "tax_123456789",
          "tax_amount": 10010
        }
      ]
    }
  ]
}
'

{
  "statusCode": 202,
  "message": "Batch operation accepted",
  "timestamp": "2021-01-01T01:01:01.000Z",
  "errors": [
    [
      "Missing field: name"
    ],
    [],
    []
  ]
}

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

x-account-id

string

required

The account identifier

Path Parameters

string

required

Body

application/json

items

object[]

required

The batch of journals to create

Show child attributes

items.reference

string | null

Reference number for the journal

Example:

"JRN-2024-001"

items.memo

string | null

Memo or description for the journal

Example:

"Monthly closing entries"

items.currency_code

object

Currency code for the journal and all lines

Show child attributes

items.currency_code.value

enum<string> | null

Default currency for the company

Available options:

AED,

AFN,

ALL,

AMD,

ANG,

AOA,

ARS,

AUD,

AWG,

AZN,

BAM,

BBD,

BDT,

BGN,

BHD,

BIF,

BMD,

BND,

BOB,

BRL,

BSD,

BTN,

BWP,

BYN,

BZD,

CAD,

CDF,

CHF,

CLP,

CNY,

COP,

CRC,

CUC,

CUP,

CVE,

CZK,

DJF,

DKK,

DOP,

DZD,

EGP,

ERN,

ETB,

EUR,

FJD,

FKP,

GBP,

GEL,

GHS,

GIP,

GMD,

GNF,

GTQ,

GYD,

HKD,

HNL,

HRK,

HTG,

HUF,

IDR,

ILS,

INR,

IQD,

IRR,

ISK,

JMD,

JOD,

JPY,

KES,

KGS,

KHR,

KMF,

KPW,

KRW,

KWD,

KYD,

KZT,

LAK,

LBP,

LKR,

LRD,

LSL,

LYD,

MAD,

MDL,

MGA,

MKD,

MMK,

MNT,

MOP,

MRU,

MUR,

MVR,

MWK,

MXN,

MYR,

MZN,

NAD,

NGN,

NIO,

NOK,

NPR,

NZD,

OMR,

PAB,

PEN,

PGK,

PHP,

PKR,

PLN,

PYG,

QAR,

RON,

RSD,

RUB,

RWF,

SAR,

SBD,

SCR,

SDG,

SEK,

SGD,

SHP,

SLL,

SOS,

SRD,

SSP,

STN,

SYP,

SZL,

THB,

TJS,

TMT,

TND,

TOP,

TRY,

TTD,

TWD,

TZS,

UAH,

UGX,

USD,

UYU,

UZS,

VES,

VND,

VUV,

WST,

XAF,

XCD,

XDR,

XOF,

XPF,

YER,

ZAR,

ZMW,

ZWL,

unmapped_value,

Example:

"USD"

items.currency_code.source_value

Example:

"USD"

items.exchange_rate

number | null

Exchange rate to company base currency to apply to all lines

Example:

1

items.transaction_date

string<date-time> | null

Date of the journal transaction

Example:

"2024-03-20T10:00:00Z"

items.lines

object[] | null

List of journal lines

Show child attributes

items.lines.account_id

string | null

ID of the ledger account this line references

Example:

"acc_123456789"

items.lines.description

string | null

Description of the journal line

Example:

"Payment for office supplies"

items.lines.amount

number | null

Amount of the journal line in minor units, e.g. 10010 for 100.10 USD. Positive for debit, negative for credit

Example:

10010

items.lines.tax_rate_id

string | null

ID of the tax rate applied

Example:

"tax_123456789"

items.lines.tax_amount

number | null

Tax amount of the line in minor units, e.g. 10010 for 100.10 USD

Example:

10010

Response

Batch operation accepted

statusCode

number | null

Example:

202

message

string | null

Example:

"Batch operation accepted"

timestamp

string<date-time> | null

Example:

"2021-01-01T01:01:01.000Z"

errors

string[][] | null

Example:

[["Missing field: name"], [], []]

Get Tax Rate List Journals

⌘I

Getting Started

API Reference

Batch Create Journals

Authorizations

Headers

Path Parameters

Body

Response