Moneybird API

Documents: General journal documents

Endpointhttps://moneybird.com/api/v2

General journal documents are used for manual bookkeeping entries, to correct errors or make adjustments.

List ids and versions of general journal documents

GET

https://moneybird.com/api/v2

/{administration_id}/documents/general_journal_documents/synchronization{format}

Returns all documents in the administration. The list contains the document id and the version of the document. Check if the version of the document is newer than the version you have stored locally, use the POST variant for fetching documents with the given ids.

List ids and versions of general journal documents › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

List ids and versions of general journal documents › query Parameters

filter

string

String terms, example: key1:value1,key2:value2.

List ids and versions of general journal documents › Responses

200

IDs and versions of records

object[]

id

integer | string

version

integer | string

GET/{administration_id}/documents/general_journal_documents/synchronization{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/documents/general_journal_documents/synchronization:format

shell

Example Responses

[
  {
    "id": "471699938509587645",
    "version": 1764068138
  },
  {
    "id": "471699938551530700",
    "version": 1764068138
  },
  {
    "id": "471699938593473755",
    "version": 1764068138
  }
]

json

application/json

Fetch general journal documents with given ids

POST

https://moneybird.com/api/v2

/{administration_id}/documents/general_journal_documents/synchronization{format}

Given a list of document ids, returns the document information belonging to the documents. Returns a maximum of 100 documents, even if more ids are provided.

Fetch general journal documents with given ids › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Fetch general journal documents with given ids › Request Body

ids

(integer | string)[] · required

Fetch general journal documents with given ids › Responses

200

A list of general journal documents

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

reference

string | null

date

string · date

journal_type

string | null · enum

Enum values:

fiscal_year_ending

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

POST/{administration_id}/documents/general_journal_documents/synchronization{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/documents/general_journal_documents/synchronization:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    471699939001369900,
    471699939044361540
  ]
}
'

shell

Example Request Body

{
  "ids": [
    471699939001369900,
    471699939044361540
  ]
}

json

application/json

Example Responses

[
  {
    "id": "471699939001369926",
    "administration_id": 123,
    "reference": "Deprecations",
    "date": "2025-11-25",
    "journal_type": null,
    "created_at": "2025-11-25T10:55:38.596Z",
    "updated_at": "2025-11-25T10:55:38.596Z",
    "version": 1764068138,
    "general_journal_document_entries": [
      {
        "id": "471699939002418503",
        "administration_id": 123,
        "ledger_account_id": "471699938976204101",
        "project_id": null,
        "contact_id": null,
        "debit": "100.0",
        "credit": "0.0",
        "row_order": 1,
        "created_at": "2025-11-25T10:55:38.598Z",
        "updated_at": "2025-11-25T10:55:38.598Z",
        "description": "First"
      },
      {
        "id": "471699939004515656",
        "administration_id": 123,
        "ledger_account_id": "471699938976204101",
        "project_id": null,
        "contact_id": null,
        "debit": "0.0",
        "credit": "100.0",
        "row_order": 2,
        "created_at": "2025-11-25T10:55:38.599Z",
        "updated_at": "2025-11-25T10:55:38.599Z",
        "description": "Second"
      },
      {
        "id": "471699939005564233",
        "administration_id": 123,
        "ledger_account_id": "471699938976204101",
        "project_id": null,
        "contact_id": null,
        "debit": "50.0",
        "credit": "0.0",
        "row_order": 3,
        "created_at": "2025-11-25T10:55:38.600Z",
        "updated_at": "2025-11-25T10:55:38.600Z",
        "description": "Third"
      },
      {
        "id": "471699939006612810",
        "administration_id": 123,
        "ledger_account_id": "471699938976204101",
        "project_id": null,
        "contact_id": null,
        "debit": "0.0",
        "credit": "50.0",
        "row_order": 4,
        "created_at": "2025-11-25T10:55:38.601Z",
        "updated_at": "2025-11-25T10:55:38.601Z",
        "description": "Fourth"
      }
    ],
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "document_saved",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-11-25T10:55:38.603Z",
        "updated_at": "2025-11-25T10:55:38.603Z"
      }
    ]
  },
  {
    "id": "471699939044361557",
    "administration_id": 123,
    "reference": "Deprecations",
    "date": "2025-11-25",
    "journal_type": null,
    "created_at": "2025-11-25T10:55:38.637Z",
    "updated_at": "2025-11-25T10:55:38.637Z",
    "version": 1764068138,
    "general_journal_document_entries": [
      {
        "id": "471699939046458710",
        "administration_id": 123,
        "ledger_account_id": "471699939018147156",
        "project_id": null,
        "contact_id": null,
        "debit": "100.0",
        "credit": "0.0",
        "row_order": 1,
        "created_at": "2025-11-25T10:55:38.639Z",
        "updated_at": "2025-11-25T10:55:38.639Z",
        "description": "First"
      },
      {
        "id": "471699939047507287",
        "administration_id": 123,
        "ledger_account_id": "471699939018147156",
        "project_id": null,
        "contact_id": null,
        "debit": "0.0",
        "credit": "100.0",
        "row_order": 2,
        "created_at": "2025-11-25T10:55:38.640Z",
        "updated_at": "2025-11-25T10:55:38.640Z",
        "description": "Second"
      },
      {
        "id": "471699939048555864",
        "administration_id": 123,
        "ledger_account_id": "471699939018147156",
        "project_id": null,
        "contact_id": null,
        "debit": "50.0",
        "credit": "0.0",
        "row_order": 3,
        "created_at": "2025-11-25T10:55:38.641Z",
        "updated_at": "2025-11-25T10:55:38.641Z",
        "description": "Third"
      },
      {
        "id": "471699939049604441",
        "administration_id": 123,
        "ledger_account_id": "471699939018147156",
        "project_id": null,
        "contact_id": null,
        "debit": "0.0",
        "credit": "50.0",
        "row_order": 4,
        "created_at": "2025-11-25T10:55:38.642Z",
        "updated_at": "2025-11-25T10:55:38.642Z",
        "description": "Fourth"
      }
    ],
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "document_saved",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-11-25T10:55:38.645Z",
        "updated_at": "2025-11-25T10:55:38.645Z"
      }
    ]
  }
]

json

application/json

Destroys note from entity

DELETE

https://moneybird.com/api/v2

/{administration_id}/documents/general_journal_documents/{general_journal_document_id}/notes/{id}{format}

Deletes a note from the general journal document.

Destroys note from entity › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

general_journal_document_id

string | integer · pattern: ^\d+$ · required

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Destroys note from entity › Responses

Note deleted

No data returned

DELETE/{administration_id}/documents/general_journal_documents/{general_journal_document_id}/notes/{id}{format}

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/documents/general_journal_documents/:general_journal_document_id/notes/:id:format

shell

Example Responses

No example specified for this content type

Adds note to entity

POST

https://moneybird.com/api/v2

/{administration_id}/documents/general_journal_documents/{general_journal_document_id}/notes{format}

Adds a note to the general journal document.

Adds note to entity › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

general_journal_document_id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Adds note to entity › Request Body

object

Adds note to entity › Responses

Note created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

entity_id

string | integer | null · pattern: ^\d+$

A unique record identifier

entity_type

string

user_id

string | integer · pattern: ^\d+$

A unique record identifier

assignee_id

string | integer | null · pattern: ^\d+$

A unique record identifier

todo

boolean | string | null

Default: false

note

string | null

completed_at

string | null · date-time

completed_by_id

string | integer | null · pattern: ^\d+$

A unique record identifier

todo_type

string | null · enum

Enum values:

sales_invoice_due

purchase_invoice_due

general_document_reminder

general_document_due

new_document_awaiting_processing

new_financial_mutation_awaiting_processing

financial_mutations_not_updated

sales_invoice_payment_not_linked_to_financial_mutation

data

object | null

created_at

string · date-time

updated_at

string · date-time

POST/{administration_id}/documents/general_journal_documents/{general_journal_document_id}/notes{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/documents/general_journal_documents/:general_journal_document_id/notes:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "note": {
    "note": "Text of the note",
    "assignee_id": 471699939341108700,
    "todo": true
  }
}
'

shell

Example Request Body

{
  "note": {
    "note": "Text of the note",
    "assignee_id": 471699939341108700,
    "todo": true
  }
}

json

application/json

Example Responses

{
  "id": "471699939361031587",
  "administration_id": 123,
  "entity_id": "471699939322234259",
  "entity_type": "Document",
  "user_id": 17640679459010,
  "assignee_id": "471699939341108641",
  "todo": true,
  "note": "Text of the note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2025-11-25T10:55:38.939Z",
  "updated_at": "2025-11-25T10:55:38.939Z"
}

json

application/json

Download attachment

GET

https://moneybird.com/api/v2

/{administration_id}/documents/general_journal_documents/{id}/attachments/{attachment_id}/download{format}

Download the attachment. The response will be a redirect to a temporarily available URL where the attachment can be downloaded. Use the Location header in the response to download the attachment.

Download attachment › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

attachment_id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Download attachment › Responses

Found

string

GET/{administration_id}/documents/general_journal_documents/{id}/attachments/{attachment_id}/download{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/documents/general_journal_documents/:id/attachments/:attachment_id/download:format

shell

Example Responses

{"message":"Use the Location header to download the attachment"}

plain

text/plain

Delete an attachment

DELETE

https://moneybird.com/api/v2

/{administration_id}/documents/general_journal_documents/{id}/attachments/{attachment_id}{format}

Deletes an attachment of an attachable.

Delete an attachment › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

attachment_id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Delete an attachment › Responses

Attachment deleted

No data returned

DELETE/{administration_id}/documents/general_journal_documents/{id}/attachments/{attachment_id}{format}

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/documents/general_journal_documents/:id/attachments/:attachment_id:format

shell

Example Responses

No example specified for this content type

Add attachment to general journal document

POST

https://moneybird.com/api/v2

/{administration_id}/documents/general_journal_documents/{id}/attachments{format}

Add an attachment to a general journal document.

Add attachment to general journal document › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Add attachment to general journal document › Request Body

file

string · binary

Add attachment to general journal document › Responses

Status code

integer

POST/{administration_id}/documents/general_journal_documents/{id}/attachments{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/documents/general_journal_documents/:id/attachments:format \
  --header 'Content-Type: application/json' \
  --data '{
  "file": "file"
}'

shell

Example Request Body

{
  "file": "file"
}

json

Example Responses

json

application/json

Get general journal document

GET

https://moneybird.com/api/v2

/{administration_id}/documents/general_journal_documents/{id}{format}

Returns a general journal document by id.

Get general journal document › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Get general journal document › Responses

A general journal document

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

reference

string | null

date

string · date

journal_type

string | null · enum

Enum values:

fiscal_year_ending

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

GET/{administration_id}/documents/general_journal_documents/{id}{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/documents/general_journal_documents/:id:format

shell

Example Responses

{
  "id": "471699936905266952",
  "administration_id": 123,
  "reference": "Deprecations",
  "date": "2025-11-25",
  "journal_type": null,
  "created_at": "2025-11-25T10:55:36.597Z",
  "updated_at": "2025-11-25T10:55:36.597Z",
  "version": 1764068136,
  "general_journal_document_entries": [
    {
      "id": "471699936907364105",
      "administration_id": 123,
      "ledger_account_id": "471699936880101127",
      "project_id": null,
      "contact_id": null,
      "debit": "100.0",
      "credit": "0.0",
      "row_order": 1,
      "created_at": "2025-11-25T10:55:36.599Z",
      "updated_at": "2025-11-25T10:55:36.599Z",
      "description": "First"
    },
    {
      "id": "471699936908412682",
      "administration_id": 123,
      "ledger_account_id": "471699936880101127",
      "project_id": null,
      "contact_id": null,
      "debit": "0.0",
      "credit": "100.0",
      "row_order": 2,
      "created_at": "2025-11-25T10:55:36.600Z",
      "updated_at": "2025-11-25T10:55:36.600Z",
      "description": "Second"
    },
    {
      "id": "471699936909461259",
      "administration_id": 123,
      "ledger_account_id": "471699936880101127",
      "project_id": null,
      "contact_id": null,
      "debit": "50.0",
      "credit": "0.0",
      "row_order": 3,
      "created_at": "2025-11-25T10:55:36.601Z",
      "updated_at": "2025-11-25T10:55:36.601Z",
      "description": "Third"
    },
    {
      "id": "471699936910509836",
      "administration_id": 123,
      "ledger_account_id": "471699936880101127",
      "project_id": null,
      "contact_id": null,
      "debit": "0.0",
      "credit": "50.0",
      "row_order": 4,
      "created_at": "2025-11-25T10:55:36.602Z",
      "updated_at": "2025-11-25T10:55:36.602Z",
      "description": "Fourth"
    }
  ],
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "document_saved",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:55:36.604Z",
      "updated_at": "2025-11-25T10:55:36.604Z"
    }
  ]
}

json

application/json

Delete a general journal document

DELETE

https://moneybird.com/api/v2

/{administration_id}/documents/general_journal_documents/{id}{format}

Deletes a general journal document.

Delete a general journal document › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Delete a general journal document › Responses

Status code

integer

DELETE/{administration_id}/documents/general_journal_documents/{id}{format}

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/documents/general_journal_documents/:id:format

shell

Example Responses

json

application/json

Update a general journal document

PATCH

https://moneybird.com/api/v2

/{administration_id}/documents/general_journal_documents/{id}{format}

Updates a general journal document.

Update a general journal document › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Update a general journal document › Request Body

object

all_taxes

boolean | string

Update a general journal document › Responses

General journal document updated

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

reference

string | null

date

string · date

journal_type

string | null · enum

Enum values:

fiscal_year_ending

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

PATCH/{administration_id}/documents/general_journal_documents/{id}{format}

curl --request PATCH \
  --url https://moneybird.com/api/v2/:administration_id/documents/general_journal_documents/:id:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "general_journal_document": {
    "reference": "updated reference"
  }
}
'

shell

Example Request Body

{
  "general_journal_document": {
    "reference": "updated reference"
  }
}

json

application/json

Example Responses

{
  "id": "471699936330647158",
  "administration_id": 123,
  "reference": "updated reference",
  "date": "2025-11-25",
  "journal_type": null,
  "created_at": "2025-11-25T10:55:36.049Z",
  "updated_at": "2025-11-25T10:55:36.085Z",
  "version": 1764068136,
  "general_journal_document_entries": [
    {
      "id": "471699936331695735",
      "administration_id": 123,
      "ledger_account_id": "471699936302335605",
      "project_id": null,
      "contact_id": null,
      "debit": "100.0",
      "credit": "0.0",
      "row_order": 1,
      "created_at": "2025-11-25T10:55:36.051Z",
      "updated_at": "2025-11-25T10:55:36.051Z",
      "description": "First"
    },
    {
      "id": "471699936332744312",
      "administration_id": 123,
      "ledger_account_id": "471699936302335605",
      "project_id": null,
      "contact_id": null,
      "debit": "0.0",
      "credit": "100.0",
      "row_order": 2,
      "created_at": "2025-11-25T10:55:36.052Z",
      "updated_at": "2025-11-25T10:55:36.052Z",
      "description": "Second"
    },
    {
      "id": "471699936333792889",
      "administration_id": 123,
      "ledger_account_id": "471699936302335605",
      "project_id": null,
      "contact_id": null,
      "debit": "50.0",
      "credit": "0.0",
      "row_order": 3,
      "created_at": "2025-11-25T10:55:36.053Z",
      "updated_at": "2025-11-25T10:55:36.053Z",
      "description": "Third"
    },
    {
      "id": "471699936334841466",
      "administration_id": 123,
      "ledger_account_id": "471699936302335605",
      "project_id": null,
      "contact_id": null,
      "debit": "0.0",
      "credit": "50.0",
      "row_order": 4,
      "created_at": "2025-11-25T10:55:36.054Z",
      "updated_at": "2025-11-25T10:55:36.054Z",
      "description": "Fourth"
    }
  ],
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "document_saved",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:55:36.056Z",
      "updated_at": "2025-11-25T10:55:36.056Z"
    },
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "document_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:55:36.087Z",
      "updated_at": "2025-11-25T10:55:36.087Z"
    }
  ]
}

json

application/json

Get general journal documents

GET

https://moneybird.com/api/v2

/{administration_id}/documents/general_journal_documents{format}

Returns a paginated list of documents of this type in the administration.

The filter argument allows you to filter on the list of documents. Filters are a combination of keys and values, separated by a comma: key:value,key2:value2. The most common filter method will be period: period:this_month. Filtering works the same as in the web application, for more advanced examples, change the filtering in the web application and learn from the resulting URI.

Get general journal documents › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Get general journal documents › query Parameters

filter

string

String terms, example: key1:value1,key2:value2.

new_filter

string

String terms, example: key1:value1,key2:value2.

page

integer | string

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

exclude_new_general_journal_documents

boolean | string

Get general journal documents › Responses

A list of general journal documents

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

reference

string | null

date

string · date

journal_type

string | null · enum

Enum values:

fiscal_year_ending

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

GET/{administration_id}/documents/general_journal_documents{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/documents/general_journal_documents:format

shell

Example Responses

[
  {
    "id": "471699937509246891",
    "administration_id": 123,
    "reference": "Deprecations",
    "date": "2025-11-25",
    "journal_type": null,
    "created_at": "2025-11-25T10:55:37.173Z",
    "updated_at": "2025-11-25T10:55:37.173Z",
    "version": 1764068137,
    "general_journal_document_entries": [
      {
        "id": "471699937510295468",
        "administration_id": 123,
        "ledger_account_id": "471699937484081066",
        "project_id": null,
        "contact_id": null,
        "debit": "100.0",
        "credit": "0.0",
        "row_order": 1,
        "created_at": "2025-11-25T10:55:37.175Z",
        "updated_at": "2025-11-25T10:55:37.175Z",
        "description": "First"
      },
      {
        "id": "471699937511344045",
        "administration_id": 123,
        "ledger_account_id": "471699937484081066",
        "project_id": null,
        "contact_id": null,
        "debit": "0.0",
        "credit": "100.0",
        "row_order": 2,
        "created_at": "2025-11-25T10:55:37.176Z",
        "updated_at": "2025-11-25T10:55:37.176Z",
        "description": "Second"
      },
      {
        "id": "471699937512392622",
        "administration_id": 123,
        "ledger_account_id": "471699937484081066",
        "project_id": null,
        "contact_id": null,
        "debit": "50.0",
        "credit": "0.0",
        "row_order": 3,
        "created_at": "2025-11-25T10:55:37.177Z",
        "updated_at": "2025-11-25T10:55:37.177Z",
        "description": "Third"
      },
      {
        "id": "471699937513441199",
        "administration_id": 123,
        "ledger_account_id": "471699937484081066",
        "project_id": null,
        "contact_id": null,
        "debit": "0.0",
        "credit": "50.0",
        "row_order": 4,
        "created_at": "2025-11-25T10:55:37.178Z",
        "updated_at": "2025-11-25T10:55:37.178Z",
        "description": "Fourth"
      }
    ],
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "document_saved",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-11-25T10:55:37.180Z",
        "updated_at": "2025-11-25T10:55:37.180Z"
      }
    ]
  }
]

json

application/json

Create a new general journal document

POST

https://moneybird.com/api/v2

/{administration_id}/documents/general_journal_documents{format}

Creates a new general journal document.

Create a new general journal document › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Create a new general journal document › Request Body

object

Create a new general journal document › Responses

General journal document created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

reference

string | null

date

string · date

journal_type

string | null · enum

Enum values:

fiscal_year_ending

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

POST/{administration_id}/documents/general_journal_documents{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/documents/general_journal_documents:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "general_journal_document": {
    "reference": "foobar",
    "general_journal_document_entries_attributes": {
      "0": {
        "ledger_account_id": 471699934737860000,
        "debit": 100,
        "credit": 0
      },
      "1": {
        "ledger_account_id": 471699934797628800,
        "debit": 0,
        "credit": 100
      }
    }
  }
}
'

shell

Example Request Body

{
  "general_journal_document": {
    "reference": "foobar",
    "general_journal_document_entries_attributes": {
      "0": {
        "ledger_account_id": 471699934737860000,
        "debit": 100,
        "credit": 0
      },
      "1": {
        "ledger_account_id": 471699934797628800,
        "debit": 0,
        "credit": 100
      }
    }
  }
}

json

application/json

Example Responses

{
  "id": "471699934829086113",
  "administration_id": 123,
  "reference": "foobar",
  "date": "2025-11-25",
  "journal_type": null,
  "created_at": "2025-11-25T10:55:34.617Z",
  "updated_at": "2025-11-25T10:55:34.617Z",
  "version": 1764068134,
  "general_journal_document_entries": [
    {
      "id": "471699934830134690",
      "administration_id": 123,
      "ledger_account_id": "471699934737859982",
      "project_id": null,
      "contact_id": null,
      "debit": "100.0",
      "credit": "0.0",
      "row_order": null,
      "created_at": "2025-11-25T10:55:34.619Z",
      "updated_at": "2025-11-25T10:55:34.619Z",
      "description": null
    },
    {
      "id": "471699934832231843",
      "administration_id": 123,
      "ledger_account_id": "471699934797628831",
      "project_id": null,
      "contact_id": null,
      "debit": "0.0",
      "credit": "100.0",
      "row_order": null,
      "created_at": "2025-11-25T10:55:34.620Z",
      "updated_at": "2025-11-25T10:55:34.620Z",
      "description": null
    }
  ],
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "document_saved",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:55:34.623Z",
      "updated_at": "2025-11-25T10:55:34.623Z"
    }
  ]
}

json

application/json

Documents: General documents Documents: Purchase invoices