Home/Accounting/Data Structures

Accounting Data Structures

Field definitions for key objects returned by Accounting APIs.

ID Format

Resources use prefixed public IDs (for example deal_..., inv_..., form_..., ak_...).

Common Fields

Core objects share common fields: `object`, `external_id`, `source_system`, `metadata`, `livemode`, `version`, `system_updated_at`, `created_by`, `updated_by`, and `deleted_at`.

JournalEntry object

Object representing a journal entry.

Fields

Name	Type	Required	Description
id	string	Required	Journal entry ID
object	string	Required	Object type (`accounting.journal_entry`)
organization_id	string	Required	Organization ID
external_id	string \| null	Optional	External ID
source_system	"salesforce" \| "import" \| "api" \| "manual"	Required	Source system
fiscal_year_id	string	Required	Fiscal year ID
date	string	Required	Journal date (YYYY-MM-DD)
description	string \| null	Optional	Description
status	"draft" \| "posted" \| "void"	Required	Status
metadata	object \| null	Optional	Additional metadata
livemode	boolean	Required	Live mode flag
version	number	Required	Revision number
created_by	string \| null	Optional	Creator ID
updated_by	string \| null	Optional	Updater ID
deleted_at	string \| null	Optional	Deleted at (ISO 8601)
created_at	string	Required	Created at (ISO 8601)
system_updated_at	string	Required	System updated at (ISO 8601)
updated_at	string	Required	Updated at (ISO 8601)

{
  "id": "je_01JQ3KXYZ",
  "object": "accounting.journal_entry",
  "organization_id": "org_01HZXYZ",
  "external_id": "ext_org_01HZXYZ",
  "source_system": "api",
  "fiscal_year_id": "fy_01JQ3KABC",
  "date": "2026-02-15",
  "description": "Office supplies purchase",
  "status": "posted",
  "metadata": {
    "source": "manual"
  },
  "livemode": false,
  "version": 4,
  "created_by": "usr_99999999999999999999999999999999",
  "updated_by": "usr_99999999999999999999999999999999",
  "deleted_at": null,
  "created_at": "2026-02-15T10:00:00Z",
  "system_updated_at": "2026-02-15T10:00:00Z",
  "updated_at": "2026-02-15T10:00:00Z"
}

Account object

Object representing a chart of accounts entry.

Fields

Name	Type	Required	Description
id	string	Required	Account ID
object	string	Required	Object type (`accounting.account`)
organization_id	string	Required	Organization ID
external_id	string \| null	Optional	External ID
source_system	"salesforce" \| "import" \| "api" \| "manual"	Required	Source system
code	string	Required	Account code
name	string	Required	Account name
category	"asset" \| "liability" \| "equity" \| "revenue" \| "expense"	Required	Account category
is_active	boolean	Required	Active flag
metadata	object \| null	Optional	Additional metadata
livemode	boolean	Required	Live mode flag
version	number	Required	Revision number
created_by	string \| null	Optional	Creator ID
updated_by	string \| null	Optional	Updater ID
deleted_at	string \| null	Optional	Deleted at (ISO 8601)
created_at	string	Required	Created at (ISO 8601)
system_updated_at	string	Required	System updated at (ISO 8601)
updated_at	string	Required	Updated at (ISO 8601)

{
  "id": "acct_01JQ3KDEF",
  "object": "accounting.account",
  "organization_id": "org_01HZXYZ",
  "external_id": "ext_org_01HZXYZ",
  "source_system": "api",
  "code": "1100",
  "name": "Cash",
  "category": "asset",
  "is_active": true,
  "metadata": {
    "source": "seed"
  },
  "livemode": false,
  "version": 1,
  "created_by": "usr_99999999999999999999999999999999",
  "updated_by": "usr_99999999999999999999999999999999",
  "deleted_at": null,
  "created_at": "2026-01-01T00:00:00Z",
  "system_updated_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z"
}

FiscalYear object

Object representing a fiscal year.

Fields

Name	Type	Required	Description
id	string	Required	Fiscal year ID
object	string	Required	Object type (`accounting.fiscal_year`)
organization_id	string	Required	Organization ID
external_id	string \| null	Optional	External ID
source_system	"salesforce" \| "import" \| "api" \| "manual"	Required	Source system
name	string	Required	Fiscal year name
start_date	string	Required	Start date
end_date	string	Required	End date
is_closed	boolean	Required	Closed flag
metadata	object \| null	Optional	Additional metadata
livemode	boolean	Required	Live mode flag
version	number	Required	Revision number
created_by	string \| null	Optional	Creator ID
updated_by	string \| null	Optional	Updater ID
deleted_at	string \| null	Optional	Deleted at (ISO 8601)
created_at	string	Required	Created at (ISO 8601)
system_updated_at	string	Required	System updated at (ISO 8601)
updated_at	string	Required	Updated at (ISO 8601)

{
  "id": "fy_01JQ3KABC",
  "object": "accounting.fiscal_year",
  "organization_id": "org_01HZXYZ",
  "external_id": "ext_org_01HZXYZ",
  "source_system": "api",
  "name": "FY2026",
  "start_date": "2026-04-01",
  "end_date": "2027-03-31",
  "is_closed": false,
  "metadata": {
    "region": "JP"
  },
  "livemode": false,
  "version": 2,
  "created_by": "usr_99999999999999999999999999999999",
  "updated_by": "usr_99999999999999999999999999999999",
  "deleted_at": null,
  "created_at": "2026-03-01T09:00:00Z",
  "system_updated_at": "2026-03-01T09:00:00Z",
  "updated_at": "2026-03-01T09:00:00Z"
}