Create Journal

curl --request POST \
  --url https://api.stackone.com/unified/accounting/companies/{id}/journals \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'x-account-id: <x-account-id>' \
  --data '
{
  "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": 201,
  "message": "Record created successfully.",
  "timestamp": "2021-01-01T01:01:01.000Z",
  "data": {
    "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"
  }
}

POST

unified

accounting

companies

{id}

journals

Create Journal

curl --request POST \
  --url https://api.stackone.com/unified/accounting/companies/{id}/journals \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'x-account-id: <x-account-id>' \
  --data '
{
  "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": 201,
  "message": "Record created successfully.",
  "timestamp": "2021-01-01T01:01:01.000Z",
  "data": {
    "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"
  }
}

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

reference

string | null

Reference number for the journal

Example:

"JRN-2024-001"

memo

string | null

Memo or description for the journal

Example:

"Monthly closing entries"

currency_code

object

Currency code for the journal and all lines

Show child attributes

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"

currency_code.source_value

Example:

"USD"

exchange_rate

number | null

Exchange rate to company base currency to apply to all lines

Example:

1

transaction_date

string<date-time> | null

Date of the journal transaction

Example:

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

lines

object[] | null

List of journal lines

Show child attributes

lines.account_id

string | null

ID of the ledger account this line references

Example:

"acc_123456789"

lines.description

string | null

Description of the journal line

Example:

"Payment for office supplies"

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

lines.tax_rate_id

string | null

ID of the tax rate applied

Example:

"tax_123456789"

lines.tax_amount

number | null

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

Example:

10010

Response

The journal was created successfully.

statusCode

number

required

Example:

201

message

string

required

Example:

"Record created successfully."

timestamp

string<date-time>

required

Example:

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

data

object

required

Show child attributes

data.id

string | null

Unique identifier

Example:

"8187e5da-dc77-475e-9949-af0f1fa4e4e3"

data.remote_id

string | null

Provider's unique identifier

Example:

"8187e5da-dc77-475e-9949-af0f1fa4e4e3"

List Journals Get Journal

⌘I

Getting Started

API Reference

Create Journal

Authorizations

Headers

Path Parameters

Body

Response