Documents: General documents

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

reference

string | null

date

string · date

due_date

string | null · date

entry_number

integer | null

state

string · enum

Enum values:

new

open

late

paid

saved

pending_payment

exchange_rate

string | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

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

curl https://moneybird.com/api/v2/:administration_id/documents/general_documents/synchronization:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "ids": [
    490992788835403000,
    490992788844840200
  ]
}'

Example Request Body

{
  "ids": [
    490992788835403000,
    490992788844840200
  ]
}

json

application/json

Example Responses

[
  {
    "id": "490992788835402991",
    "administration_id": 123,
    "contact_id": null,
    "contact": null,
    "reference": "Contract",
    "date": "2026-06-26",
    "due_date": null,
    "entry_number": 3,
    "state": "saved",
    "exchange_rate": "1.0",
    "created_at": "2026-06-26T09:47:13.973Z",
    "updated_at": "2026-06-26T09:47:13.973Z",
    "version": 1782467233,
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": "490992723746096229",
        "action": "document_saved",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-06-26T09:47:13.976Z",
        "updated_at": "2026-06-26T09:47:13.976Z"
      }
    ]
  },
  {
    "id": "490992788844840177",
    "administration_id": 123,
    "contact_id": null,
    "contact": null,
    "reference": "Contract",
    "date": "2026-06-26",
    "due_date": null,
    "entry_number": 4,
    "state": "saved",
    "exchange_rate": "1.0",
    "created_at": "2026-06-26T09:47:13.982Z",
    "updated_at": "2026-06-26T09:47:13.982Z",
    "version": 1782467233,
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": "490992723746096229",
        "action": "document_saved",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-06-26T09:47:13.985Z",
        "updated_at": "2026-06-26T09:47:13.985Z"
      }
    ]
  }
]

json

application/json

Destroys note from entity

DELETE

https://moneybird.com/api/v2

/{administration_id}/documents/general_documents/{general_document_id}/notes/{id}{format}

Deletes a note from the general document.

Required scope(s)

documents

Destroys note from entity › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

general_document_id

identifier · pattern: ^\d+$ · required

A unique record identifier

id

identifier · 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

Adds note to entity

POST

https://moneybird.com/api/v2

/{administration_id}/documents/general_documents/{general_document_id}/notes{format}

Adds a note to the general document.

Required scope(s)

documents

Adds note to entity › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

general_document_id

identifier · 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

note_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

entity_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

entity_type

string

user_id

identifier · pattern: ^\d+$

A unique record identifier

assignee_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

todo

boolean | string | null

Default: false

note

string | null

completed_at

string | null · date-time

completed_by_id

identifier_nullable · 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

timestamp · date-time

updated_at

timestamp · date-time

POST/{administration_id}/documents/general_documents/{general_document_id}/notes{format}

curl https://moneybird.com/api/v2/:administration_id/documents/general_documents/:general_document_id/notes:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "note": {
    "note": "Text of the note",
    "assignee_id": 490992788270220400,
    "todo": true
  }
}'

Example Request Body

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

json

application/json

Example Responses

{
  "id": "490992788285949040",
  "administration_id": 123,
  "entity_id": "490992788258686060",
  "entity_type": "Document",
  "user_id": "490992723746096229",
  "assignee_id": "490992788270220398",
  "todo": true,
  "note": "Text of the note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2026-06-26T09:47:13.450Z",
  "updated_at": "2026-06-26T09:47:13.450Z"
}

json

application/json

Download attachment

GET

https://moneybird.com/api/v2

/{administration_id}/documents/general_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.

Required scope(s)

documents

Download attachment › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

attachment_id

identifier · 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

Delete an attachment

DELETE

https://moneybird.com/api/v2

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

Deletes an attachment of an attachable.

Required scope(s)

documents

Delete an attachment › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

attachment_id

identifier · 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

Add attachment to general document

POST

https://moneybird.com/api/v2

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

Add an attachment to a general document.

Required scope(s)

documents

Add attachment to general document › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · 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 document › Request Body

file

string · binary

Add attachment to general document › Responses

Status code

integer

Get general document

GET

https://moneybird.com/api/v2

/{administration_id}/documents/general_documents/{id}{format}

Returns a general document by id.

Required scope(s)

documents

Get general document › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · 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 document › Responses

A general document

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

reference

string | null

date

string · date

due_date

string | null · date

entry_number

integer | null

state

string · enum

Enum values:

new

open

late

paid

saved

pending_payment

exchange_rate

string | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

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

curl https://moneybird.com/api/v2/:administration_id/documents/general_documents/:id:format \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": "490992788100351050",
  "administration_id": 123,
  "contact_id": null,
  "contact": null,
  "reference": "Contract",
  "date": "2026-06-26",
  "due_date": null,
  "entry_number": 2,
  "state": "saved",
  "exchange_rate": "1.0",
  "created_at": "2026-06-26T09:47:13.273Z",
  "updated_at": "2026-06-26T09:47:13.273Z",
  "version": 1782467233,
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "490992723746096229",
      "action": "document_saved",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-06-26T09:47:13.275Z",
      "updated_at": "2026-06-26T09:47:13.275Z"
    }
  ]
}

json

application/json

Delete a general document

DELETE

https://moneybird.com/api/v2

/{administration_id}/documents/general_documents/{id}{format}

Deletes a general document.

Required scope(s)

documents

Delete a general document › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · 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 document › Responses

Status code

integer

Update a general document

PATCH

https://moneybird.com/api/v2

/{administration_id}/documents/general_documents/{id}{format}

Updates a general document.

Required scope(s)

documents

Update a general document › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · 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 document › Request Body

object

remove_contact

boolean | string

Update a general document › Responses

General document updated

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

reference

string | null

date

string · date

due_date

string | null · date

entry_number

integer | null

state

string · enum

Enum values:

new

open

late

paid

saved

pending_payment

exchange_rate

string | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

general_document_response[]

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

curl https://moneybird.com/api/v2/:administration_id/documents/general_documents/:id:format \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "general_document": {
    "reference": "updated reference"
  }
}'

Example Request Body

{
  "general_document": {
    "reference": "updated reference"
  }
}

json

application/json

Example Responses

{
  "id": "490992790554019299",
  "administration_id": 123,
  "contact_id": null,
  "contact": null,
  "reference": "updated reference",
  "date": "2026-06-26",
  "due_date": null,
  "entry_number": 2,
  "state": "saved",
  "exchange_rate": "1.0",
  "created_at": "2026-06-26T09:47:15.612Z",
  "updated_at": "2026-06-26T09:47:15.631Z",
  "version": 1782467235,
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "490992723746096229",
      "action": "document_saved",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-06-26T09:47:15.615Z",
      "updated_at": "2026-06-26T09:47:15.615Z"
    },
    {
      "administration_id": 123,
      "user_id": "490992723746096229",
      "action": "document_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-06-26T09:47:15.633Z",
      "updated_at": "2026-06-26T09:47:15.633Z"
    }
  ]
}

json

application/json

Get general documents

GET

https://moneybird.com/api/v2

/{administration_id}/documents/general_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: period:this_year,state:open. The available options for filtering are:

Filter	Type	Default	Description
period	`String`	`this_year`	A named period (`this_month`, `prev_month`, `next_month`, `this_quarter`, `prev_quarter`, `next_quarter`, `this_year`, `prev_year`, `next_year`) or a custom range (`201301..201302`, `20130101..20130131`)
state	`String`	`all`	`all`, `new`, `saved`, `open`, `paid`, `late` or `pending_payment`. `paid`, `late` and `pending_payment` only apply to documents with a payment lifecycle (purchase invoices and receipts)
recurring	`String`	`all`	`all`, `enabled` or `disabled`
attachment	`String`	`all`	`all`, `with` or `without`
reference	`String`		Documents with the given reference value
contact_id	`Integer`		Documents belonging to the given contact
ledger_account_id	`Integer`		Documents booking against the given ledger account
updated_after	`String`		ISO 8601 timestamp in UTC; documents updated strictly after this time

Multiple values for state, recurring and attachment can be combined with a pipe, e.g. state:open|paid.

The new_filter argument accepts the same key:value vocabulary as filter; keys present in new_filter override the corresponding key in filter. Useful for changing one value (such as period) without restating the rest.

Required scope(s)

documents

Get general documents › path Parameters

administration_id

administration_id · 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 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+$

Get general documents › Responses

A list of general documents

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

reference

string | null

date

string · date

due_date

string | null · date

entry_number

integer | null

state

string · enum

Enum values:

new

open

late

paid

saved

pending_payment

exchange_rate

string | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

GET/{administration_id}/documents/general_documents{format}

curl https://moneybird.com/api/v2/:administration_id/documents/general_documents:format \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "id": "490992791138076265",
    "administration_id": 123,
    "contact_id": null,
    "contact": null,
    "reference": "Contract",
    "date": "2026-06-26",
    "due_date": null,
    "entry_number": 5,
    "state": "saved",
    "exchange_rate": "1.0",
    "created_at": "2026-06-26T09:47:16.170Z",
    "updated_at": "2026-06-26T09:47:16.170Z",
    "version": 1782467236,
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": "490992723746096229",
        "action": "document_saved",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-06-26T09:47:16.172Z",
        "updated_at": "2026-06-26T09:47:16.172Z"
      }
    ]
  },
  {
    "id": "490992791128639079",
    "administration_id": 123,
    "contact_id": null,
    "contact": null,
    "reference": "Contract",
    "date": "2026-06-26",
    "due_date": null,
    "entry_number": 4,
    "state": "saved",
    "exchange_rate": "1.0",
    "created_at": "2026-06-26T09:47:16.161Z",
    "updated_at": "2026-06-26T09:47:16.161Z",
    "version": 1782467236,
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": "490992723746096229",
        "action": "document_saved",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-06-26T09:47:16.163Z",
        "updated_at": "2026-06-26T09:47:16.163Z"
      }
    ]
  },
  {
    "id": "490992791119201893",
    "administration_id": 123,
    "contact_id": null,
    "contact": null,
    "reference": "Contract",
    "date": "2026-06-26",
    "due_date": null,
    "entry_number": 3,
    "state": "saved",
    "exchange_rate": "1.0",
    "created_at": "2026-06-26T09:47:16.152Z",
    "updated_at": "2026-06-26T09:47:16.152Z",
    "version": 1782467236,
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": "490992723746096229",
        "action": "document_saved",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-06-26T09:47:16.154Z",
        "updated_at": "2026-06-26T09:47:16.154Z"
      }
    ]
  },
  {
    "id": "490992791109764707",
    "administration_id": 123,
    "contact_id": null,
    "contact": null,
    "reference": "Contract",
    "date": "2026-06-26",
    "due_date": null,
    "entry_number": 2,
    "state": "saved",
    "exchange_rate": "1.0",
    "created_at": "2026-06-26T09:47:16.143Z",
    "updated_at": "2026-06-26T09:47:16.143Z",
    "version": 1782467236,
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": "490992723746096229",
        "action": "document_saved",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-06-26T09:47:16.145Z",
        "updated_at": "2026-06-26T09:47:16.145Z"
      }
    ]
  }
]

json

application/json

Create a new general document

POST

https://moneybird.com/api/v2

/{administration_id}/documents/general_documents{format}

Creates a new general document.

Required scope(s)

documents

Create a new general document › path Parameters

administration_id

administration_id · 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 document › Request Body

object

Create a new general document › Responses

General document created

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

reference

string | null

date

string · date

due_date

string | null · date

entry_number

integer | null

state

string · enum

Enum values:

new

open

late

paid

saved

pending_payment

exchange_rate

string | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

version