Documents: Typeless 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

state

string · enum

Enum values:

new

open

late

paid

saved

pending_payment

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

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

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

Example Request Body

{
  "ids": [
    501033122496775600,
    501033122500969900
  ]
}

json

application/json

Example Responses

[
  {
    "id": "501033122496775630",
    "administration_id": 123,
    "contact_id": null,
    "contact": null,
    "reference": "20130456",
    "date": "2026-10-15",
    "state": "new",
    "origin": null,
    "created_at": "2026-10-15T05:34:02.315Z",
    "updated_at": "2026-10-15T05:34:02.315Z",
    "version": 1792042442,
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": "501033067832411237",
        "action": "document_saved",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-10-15T05:34:02.316Z",
        "updated_at": "2026-10-15T05:34:02.316Z"
      }
    ]
  },
  {
    "id": "501033122500969936",
    "administration_id": 123,
    "contact_id": null,
    "contact": null,
    "reference": "20130456",
    "date": "2026-10-15",
    "state": "new",
    "origin": null,
    "created_at": "2026-10-15T05:34:02.319Z",
    "updated_at": "2026-10-15T05:34:02.319Z",
    "version": 1792042442,
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": "501033067832411237",
        "action": "document_saved",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-10-15T05:34:02.320Z",
        "updated_at": "2026-10-15T05:34:02.320Z"
      }
    ]
  }
]

json

application/json

Download attachment

GET

https://moneybird.com/api/v2

/{administration_id}/documents/typeless_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/typeless_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 typeless document

POST

https://moneybird.com/api/v2

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

Add an attachment to a typeless document.

Required scope(s)

documents

Add attachment to typeless 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 typeless document › Request Body

file

string · binary

Add attachment to typeless document › Responses

Status code

integer

Get a typeless document

GET

https://moneybird.com/api/v2

/{administration_id}/documents/typeless_documents/{id}{format}

Returns a typeless document by id.

Required scope(s)

documents

Get a typeless 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 a typeless document › Responses

A typeless 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

state

string · enum

Enum values:

new

open

late

paid

saved

pending_payment

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

typeless_document_response[]

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

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

Example Responses

{
  "id": "501033122159133985",
  "administration_id": 123,
  "contact_id": null,
  "contact": null,
  "reference": "20130456",
  "date": "2026-10-15",
  "state": "new",
  "origin": null,
  "created_at": "2026-10-15T05:34:01.993Z",
  "updated_at": "2026-10-15T05:34:01.993Z",
  "version": 1792042441,
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "501033067832411237",
      "action": "document_saved",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-10-15T05:34:01.994Z",
      "updated_at": "2026-10-15T05:34:01.994Z"
    }
  ]
}

json

application/json

Delete a typeless document

DELETE

https://moneybird.com/api/v2

/{administration_id}/documents/typeless_documents/{id}{format}

Deletes a typeless document.

Required scope(s)

documents

Delete a typeless 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 typeless document › Responses

Status code

integer

Get typeless documents

GET

https://moneybird.com/api/v2

/{administration_id}/documents/typeless_documents{format}

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

Required scope(s)

documents

Get typeless 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 typeless documents › query Parameters

filter

string

Filters are key:value terms separated by commas (e.g. period:this_year,state:open). Any filter you pass replaces the defaults below entirely, so include every key you need — in particular pass an explicit period (a named period or a YYYYMMDD..YYYYMMDD range) to look beyond the default financial year. Available filters:

Filter	Type	Default	Description
period	`String`	`this_year`	A named period (`this_week`, `prev_week`, `next_week`, `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.

Default: period:this_year

new_filter

string

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

page

integer | string

sort

string · enum

Sorts the list on date, so the newest (date_desc) or the oldest (date_asc) items come first.

Enum values:

date_desc

date_asc

Default: date_desc

per_page

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

Get typeless documents › Responses

A list of typeless 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

state

string · enum

Enum values:

new

open

late

paid

saved

pending_payment

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

GET/{administration_id}/documents/typeless_documents{format}

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

Example Responses

[
  {
    "id": "501033122230437191",
    "administration_id": 123,
    "contact_id": null,
    "contact": null,
    "reference": "20130456",
    "date": "2026-10-15",
    "state": "new",
    "origin": null,
    "created_at": "2026-10-15T05:34:02.061Z",
    "updated_at": "2026-10-15T05:34:02.061Z",
    "version": 1792042442,
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": "501033067832411237",
        "action": "document_saved",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-10-15T05:34:02.062Z",
        "updated_at": "2026-10-15T05:34:02.062Z"
      }
    ]
  }
]

json

application/json

Create a new typeless document

POST

https://moneybird.com/api/v2

/{administration_id}/documents/typeless_documents{format}

Creates a new typeless document.

Required scope(s)

documents

Create a new typeless 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 typeless document › Request Body

object

Create a new typeless document › Responses

Typeless 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

state

string · enum

Enum values:

new

open

late

paid

saved

pending_payment

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

created_at

timestamp · date-time

updated_at

timestamp · date-time

version