Moneybird API

Documents: Receipts

Endpointhttps://moneybird.com/api/v2

Receipts are proofs of payment for expenses.

List ids and versions of receipts

GET

https://moneybird.com/api/v2

/{administration_id}/documents/receipts/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 receipts › 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 receipts › query Parameters

filter

string

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

List ids and versions of receipts › Responses

200

IDs and versions of records

object[]

id

integer | string

version

integer | string

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

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

shell

Example Responses

[
  {
    "id": "471699887338030094",
    "version": 1764068089
  },
  {
    "id": "471699887407236128",
    "version": 1764068089
  },
  {
    "id": "471699887439741993",
    "version": 1764068089
  }
]

json

application/json

Fetch receipts with given ids

POST

https://moneybird.com/api/v2

/{administration_id}/documents/receipts/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 receipts 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 receipts with given ids › Request Body

ids

(integer | string)[] · required

Fetch receipts with given ids › Responses

200

A list of receipts

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer | null · 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

currency

string | null

revenue_invoice

boolean | null

prices_are_incl_tax

boolean | null

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

paid_at

string | null · date

tax_number

string | null

total_price_excl_tax

string | null

total_price_excl_tax_base

string | null

total_price_incl_tax

string | null

total_price_incl_tax_base

string | null

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

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

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

shell

Example Request Body

{
  "ids": [
    471699887757460600,
    471699887785772160
  ]
}

json

application/json

Example Responses

[
  {
    "id": "471699887757460594",
    "administration_id": 123,
    "contact_id": "471699887664137309",
    "contact": {
      "id": "471699887664137309",
      "administration_id": 123,
      "company_name": "Foobar Holding B.V.",
      "firstname": "",
      "lastname": "",
      "address1": "Hoofdstraat 12",
      "address2": "",
      "zipcode": "1234AB",
      "city": "Amsterdam",
      "country": "NL",
      "phone": "",
      "delivery_method": "Email",
      "customer_id": "1",
      "tax_number": "",
      "chamber_of_commerce": "",
      "bank_account": "",
      "is_trusted": false,
      "max_transfer_amount": null,
      "attention": "",
      "email": "info@example.com",
      "email_ubl": true,
      "send_invoices_to_attention": "",
      "send_invoices_to_email": "info@example.com",
      "send_estimates_to_attention": "",
      "send_estimates_to_email": "info@example.com",
      "sepa_active": false,
      "sepa_iban": "",
      "sepa_iban_account_name": "",
      "sepa_bic": "",
      "sepa_mandate_id": "",
      "sepa_mandate_date": null,
      "sepa_sequence_type": "RCUR",
      "credit_card_number": "",
      "credit_card_reference": "",
      "credit_card_type": null,
      "tax_number_validated_at": null,
      "tax_number_valid": null,
      "invoice_workflow_id": null,
      "estimate_workflow_id": null,
      "si_identifier": "",
      "si_identifier_type": null,
      "moneybird_payments_mandate": false,
      "created_at": "2025-11-25T10:54:49.637Z",
      "updated_at": "2025-11-25T10:54:49.637Z",
      "version": 1764068089,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/9c40109f1615d1d1a5e313fe24d499c13c4dcfa8aeb8f940bee5d0f422cd0dcd/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "reference": "Lunch supermarket",
    "date": "2025-11-25",
    "due_date": null,
    "entry_number": 3,
    "state": "open",
    "currency": "EUR",
    "exchange_rate": "1.0",
    "revenue_invoice": false,
    "prices_are_incl_tax": true,
    "origin": null,
    "paid_at": null,
    "tax_number": "",
    "total_price_excl_tax": "247.93",
    "total_price_excl_tax_base": "247.93",
    "total_price_incl_tax": "300.0",
    "total_price_incl_tax_base": "300.0",
    "created_at": "2025-11-25T10:54:49.727Z",
    "updated_at": "2025-11-25T10:54:49.729Z",
    "version": 1764068089,
    "details": [
      {
        "id": "471699887759557747",
        "administration_id": 123,
        "tax_rate_id": "471699736836965514",
        "ledger_account_id": "471699736746787958",
        "project_id": null,
        "product_id": null,
        "amount": null,
        "amount_decimal": "1.0",
        "description": "Delivery Apple iPad",
        "price": "300.0",
        "period": null,
        "row_order": 0,
        "total_price_excl_tax_with_discount": "247.93",
        "total_price_excl_tax_with_discount_base": "247.93",
        "tax_report_reference": [
          "NL/5b"
        ],
        "mandatory_tax_text": null,
        "created_at": "2025-11-25T10:54:49.728Z",
        "updated_at": "2025-11-25T10:54:49.728Z"
      }
    ],
    "payments": [],
    "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:54:49.731Z",
        "updated_at": "2025-11-25T10:54:49.731Z"
      }
    ]
  },
  {
    "id": "471699887785772155",
    "administration_id": 123,
    "contact_id": "471699887664137309",
    "contact": {
      "id": "471699887664137309",
      "administration_id": 123,
      "company_name": "Foobar Holding B.V.",
      "firstname": "",
      "lastname": "",
      "address1": "Hoofdstraat 12",
      "address2": "",
      "zipcode": "1234AB",
      "city": "Amsterdam",
      "country": "NL",
      "phone": "",
      "delivery_method": "Email",
      "customer_id": "1",
      "tax_number": "",
      "chamber_of_commerce": "",
      "bank_account": "",
      "is_trusted": false,
      "max_transfer_amount": null,
      "attention": "",
      "email": "info@example.com",
      "email_ubl": true,
      "send_invoices_to_attention": "",
      "send_invoices_to_email": "info@example.com",
      "send_estimates_to_attention": "",
      "send_estimates_to_email": "info@example.com",
      "sepa_active": false,
      "sepa_iban": "",
      "sepa_iban_account_name": "",
      "sepa_bic": "",
      "sepa_mandate_id": "",
      "sepa_mandate_date": null,
      "sepa_sequence_type": "RCUR",
      "credit_card_number": "",
      "credit_card_reference": "",
      "credit_card_type": null,
      "tax_number_validated_at": null,
      "tax_number_valid": null,
      "invoice_workflow_id": null,
      "estimate_workflow_id": null,
      "si_identifier": "",
      "si_identifier_type": null,
      "moneybird_payments_mandate": false,
      "created_at": "2025-11-25T10:54:49.637Z",
      "updated_at": "2025-11-25T10:54:49.637Z",
      "version": 1764068089,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/9c40109f1615d1d1a5e313fe24d499c13c4dcfa8aeb8f940bee5d0f422cd0dcd/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "reference": "Lunch supermarket",
    "date": "2025-11-25",
    "due_date": null,
    "entry_number": 4,
    "state": "open",
    "currency": "EUR",
    "exchange_rate": "1.0",
    "revenue_invoice": false,
    "prices_are_incl_tax": true,
    "origin": null,
    "paid_at": null,
    "tax_number": "",
    "total_price_excl_tax": "247.93",
    "total_price_excl_tax_base": "247.93",
    "total_price_incl_tax": "300.0",
    "total_price_incl_tax_base": "300.0",
    "created_at": "2025-11-25T10:54:49.753Z",
    "updated_at": "2025-11-25T10:54:49.756Z",
    "version": 1764068089,
    "details": [
      {
        "id": "471699887786820732",
        "administration_id": 123,
        "tax_rate_id": "471699736836965514",
        "ledger_account_id": "471699736746787958",
        "project_id": null,
        "product_id": null,
        "amount": null,
        "amount_decimal": "1.0",
        "description": "Delivery Apple iPad",
        "price": "300.0",
        "period": null,
        "row_order": 0,
        "total_price_excl_tax_with_discount": "247.93",
        "total_price_excl_tax_with_discount_base": "247.93",
        "tax_report_reference": [
          "NL/5b"
        ],
        "mandatory_tax_text": null,
        "created_at": "2025-11-25T10:54:49.754Z",
        "updated_at": "2025-11-25T10:54:49.754Z"
      }
    ],
    "payments": [],
    "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:54:49.757Z",
        "updated_at": "2025-11-25T10:54:49.757Z"
      }
    ]
  }
]

json

application/json

Download attachment

GET

https://moneybird.com/api/v2

/{administration_id}/documents/receipts/{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/receipts/{id}/attachments/{attachment_id}/download{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/documents/receipts/: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/receipts/{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/receipts/{id}/attachments/{attachment_id}{format}

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

shell

Example Responses

No example specified for this content type

Add attachment to receipt

POST

https://moneybird.com/api/v2

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

Add an attachment to a receipt.

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

file

string · binary

Add attachment to receipt › Responses

Status code

integer

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

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

shell

Example Request Body

{
  "file": "file"
}

json

Example Responses

json

application/json

Delete a payment

DELETE

https://moneybird.com/api/v2

/{administration_id}/documents/receipts/{id}/payments/{payment_id}{format}

Deletes a payment from a receipt.

Delete a payment › 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

payment_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 payment › Responses

Payment deleted

No data returned

DELETE/{administration_id}/documents/receipts/{id}/payments/{payment_id}{format}

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

shell

Example Responses

No example specified for this content type

Create a payment

POST

https://moneybird.com/api/v2

/{administration_id}/documents/receipts/{id}/payments{format}

Registers a payment for a receipt.

Create a payment › 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

Create a payment › Request Body

object

Create a payment › Responses

Payment created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

invoice_type

string · enum

Enum values:

SalesInvoice

Document

ExternalSalesInvoice

VatDocument

invoice_id

string | integer · pattern: ^\d+$

A unique record identifier

financial_account_id

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

A unique record identifier

user_id

string | integer · pattern: ^\d+$

A unique record identifier

payment_transaction_id

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

A unique record identifier

transaction_identifier

string | null

payment_date

string · date

credit_invoice_id

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

A unique record identifier

financial_mutation_id

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

A unique record identifier

ledger_account_id

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

A unique record identifier

linked_payment_id

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

A unique record identifier

manual_payment_action

string | null

created_at

string · date-time

updated_at

string · date-time

POST/{administration_id}/documents/receipts/{id}/payments{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/documents/receipts/:id/payments:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "payment": {
    "payment_date": "2025-11-25T10:54:52.531Z",
    "price": "300.0"
  }
}
'

shell

Example Request Body

{
  "payment": {
    "payment_date": "2025-11-25T10:54:52.531Z",
    "price": "300.0"
  }
}

json

application/json

Example Responses

{
  "id": "471699890713396940",
  "administration_id": 123,
  "invoice_type": "Document",
  "invoice_id": "471699890645239482",
  "financial_account_id": null,
  "user_id": 17640679459010,
  "payment_transaction_id": null,
  "transaction_identifier": null,
  "price": "300.0",
  "price_base": "300.0",
  "payment_date": "2025-11-25",
  "credit_invoice_id": null,
  "financial_mutation_id": null,
  "ledger_account_id": "471699736780342399",
  "linked_payment_id": null,
  "manual_payment_action": null,
  "created_at": "2025-11-25T10:54:52.545Z",
  "updated_at": "2025-11-25T10:54:52.545Z"
}

json

application/json

deprecated

Register a payment for a receipt

PATCH

https://moneybird.com/api/v2

/{administration_id}/documents/receipts/{id}/register_payment{format}

This endpoint is deprecated and should no longer be used. It has been replaced by Create a payment.

Register a payment for a receipt › 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

Register a payment for a receipt › Request Body

object

Register a payment for a receipt › Responses

Status code

integer

PATCH/{administration_id}/documents/receipts/{id}/register_payment{format}

curl --request PATCH \
  --url https://moneybird.com/api/v2/:administration_id/documents/receipts/:id/register_payment:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "payment": {
    "payment_date": "2025-11-25T10:54:50.608Z",
    "price": "300.0"
  }
}
'

shell

Example Request Body

{
  "payment": {
    "payment_date": "2025-11-25T10:54:50.608Z",
    "price": "300.0"
  }
}

json

application/json

Example Responses

json

application/json

Get a receipt

GET

https://moneybird.com/api/v2

/{administration_id}/documents/receipts/{id}{format}

Returns a receipt by id.

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

A receipt

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer | null · 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

currency

string | null

revenue_invoice

boolean | null

prices_are_incl_tax

boolean | null

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

paid_at

string | null · date

tax_number

string | null

total_price_excl_tax

string | null

total_price_excl_tax_base

string | null

total_price_incl_tax

string | null

total_price_incl_tax_base

string | null

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

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

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

shell

Example Responses

{
  "id": "471699890912626410",
  "administration_id": 123,
  "contact_id": "471699890881169127",
  "contact": {
    "id": "471699890881169127",
    "administration_id": 123,
    "company_name": "Foobar Holding B.V.",
    "firstname": "",
    "lastname": "",
    "address1": "Hoofdstraat 12",
    "address2": "",
    "zipcode": "1234AB",
    "city": "Amsterdam",
    "country": "NL",
    "phone": "",
    "delivery_method": "Email",
    "customer_id": "1",
    "tax_number": "",
    "chamber_of_commerce": "",
    "bank_account": "",
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": "",
    "email": "info@example.com",
    "email_ubl": true,
    "send_invoices_to_attention": "",
    "send_invoices_to_email": "info@example.com",
    "send_estimates_to_attention": "",
    "send_estimates_to_email": "info@example.com",
    "sepa_active": false,
    "sepa_iban": "",
    "sepa_iban_account_name": "",
    "sepa_bic": "",
    "sepa_mandate_id": "",
    "sepa_mandate_date": null,
    "sepa_sequence_type": "RCUR",
    "credit_card_number": "",
    "credit_card_reference": "",
    "credit_card_type": null,
    "tax_number_validated_at": null,
    "tax_number_valid": null,
    "invoice_workflow_id": null,
    "estimate_workflow_id": null,
    "si_identifier": "",
    "si_identifier_type": null,
    "moneybird_payments_mandate": false,
    "created_at": "2025-11-25T10:54:52.705Z",
    "updated_at": "2025-11-25T10:54:52.705Z",
    "version": 1764068092,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/fde213c09335d63aea3b8224288c4e3acb9a06dd824c5ee3cfba82ad1243b8ab/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "reference": "Lunch supermarket",
  "date": "2025-11-25",
  "due_date": null,
  "entry_number": 1,
  "state": "open",
  "currency": "EUR",
  "exchange_rate": "1.0",
  "revenue_invoice": false,
  "prices_are_incl_tax": true,
  "origin": null,
  "paid_at": null,
  "tax_number": "",
  "total_price_excl_tax": "247.93",
  "total_price_excl_tax_base": "247.93",
  "total_price_incl_tax": "300.0",
  "total_price_incl_tax_base": "300.0",
  "created_at": "2025-11-25T10:54:52.735Z",
  "updated_at": "2025-11-25T10:54:52.739Z",
  "version": 1764068092,
  "details": [
    {
      "id": "471699890914723563",
      "administration_id": 123,
      "tax_rate_id": "471699736836965514",
      "ledger_account_id": "471699736746787958",
      "project_id": null,
      "product_id": null,
      "amount": null,
      "amount_decimal": "1.0",
      "description": "Delivery Apple iPad",
      "price": "300.0",
      "period": null,
      "row_order": 0,
      "total_price_excl_tax_with_discount": "247.93",
      "total_price_excl_tax_with_discount_base": "247.93",
      "tax_report_reference": [
        "NL/5b"
      ],
      "mandatory_tax_text": null,
      "created_at": "2025-11-25T10:54:52.737Z",
      "updated_at": "2025-11-25T10:54:52.737Z"
    }
  ],
  "payments": [],
  "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:54:52.741Z",
      "updated_at": "2025-11-25T10:54:52.741Z"
    }
  ]
}

json

application/json

Delete a receipts

DELETE

https://moneybird.com/api/v2

/{administration_id}/documents/receipts/{id}{format}

Deletes a receipt.

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

Status code

integer

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

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

shell

Example Responses

json

application/json

Update a receipt

PATCH

https://moneybird.com/api/v2

/{administration_id}/documents/receipts/{id}{format}

Updates a receipt.

Update a receipt › 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 receipt › Request Body

object

Update a receipt › Responses

Receipt updated

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer | null · 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

currency

string | null

revenue_invoice

boolean | null

prices_are_incl_tax

boolean | null

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

paid_at

string | null · date

tax_number

string | null

total_price_excl_tax

string | null

total_price_excl_tax_base

string | null

total_price_incl_tax

string | null

total_price_incl_tax_base

string | null

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

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

curl --request PATCH \
  --url https://moneybird.com/api/v2/:administration_id/documents/receipts/:id:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "receipt": {
    "details_attributes": {
      "0": {
        "id": 471699889928013400,
        "description": "updated description",
        "price": 20
      }
    }
  }
}
'

shell

Example Request Body

{
  "receipt": {
    "details_attributes": {
      "0": {
        "id": 471699889928013400,
        "description": "updated description",
        "price": 20
      }
    }
  }
}

json

application/json

Example Responses

{
  "id": "471699889925916205",
  "administration_id": 123,
  "contact_id": "471699889896556074",
  "contact": {
    "id": "471699889896556074",
    "administration_id": 123,
    "company_name": "Foobar Holding B.V.",
    "firstname": "",
    "lastname": "",
    "address1": "Hoofdstraat 12",
    "address2": "",
    "zipcode": "1234AB",
    "city": "Amsterdam",
    "country": "NL",
    "phone": "",
    "delivery_method": "Email",
    "customer_id": "1",
    "tax_number": "",
    "chamber_of_commerce": "",
    "bank_account": "",
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": "",
    "email": "info@example.com",
    "email_ubl": true,
    "send_invoices_to_attention": "",
    "send_invoices_to_email": "info@example.com",
    "send_estimates_to_attention": "",
    "send_estimates_to_email": "info@example.com",
    "sepa_active": false,
    "sepa_iban": "",
    "sepa_iban_account_name": "",
    "sepa_bic": "",
    "sepa_mandate_id": "",
    "sepa_mandate_date": null,
    "sepa_sequence_type": "RCUR",
    "credit_card_number": "",
    "credit_card_reference": "",
    "credit_card_type": null,
    "tax_number_validated_at": null,
    "tax_number_valid": null,
    "invoice_workflow_id": null,
    "estimate_workflow_id": null,
    "si_identifier": "",
    "si_identifier_type": null,
    "moneybird_payments_mandate": false,
    "created_at": "2025-11-25T10:54:51.766Z",
    "updated_at": "2025-11-25T10:54:51.766Z",
    "version": 1764068091,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/a8916b09440d9c125b7d08351521113079727f1b7b2b84e2c443c64a92308e2f/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "reference": "Lunch supermarket",
  "date": "2025-11-25",
  "due_date": null,
  "entry_number": 1,
  "state": "open",
  "currency": "EUR",
  "exchange_rate": "1.0",
  "revenue_invoice": false,
  "prices_are_incl_tax": true,
  "origin": null,
  "paid_at": null,
  "tax_number": "",
  "total_price_excl_tax": "16.53",
  "total_price_excl_tax_base": "16.53",
  "total_price_incl_tax": "20.0",
  "total_price_incl_tax_base": "20.0",
  "created_at": "2025-11-25T10:54:51.795Z",
  "updated_at": "2025-11-25T10:54:51.871Z",
  "version": 1764068091,
  "details": [
    {
      "id": "471699889928013358",
      "administration_id": 123,
      "tax_rate_id": "471699736836965514",
      "ledger_account_id": "471699736746787958",
      "project_id": null,
      "product_id": null,
      "amount": null,
      "amount_decimal": "1.0",
      "description": "updated description",
      "price": "20.0",
      "period": null,
      "row_order": 0,
      "total_price_excl_tax_with_discount": "16.53",
      "total_price_excl_tax_with_discount_base": "16.53",
      "tax_report_reference": [
        "NL/5b"
      ],
      "mandatory_tax_text": null,
      "created_at": "2025-11-25T10:54:51.797Z",
      "updated_at": "2025-11-25T10:54:51.870Z"
    }
  ],
  "payments": [],
  "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:54:51.800Z",
      "updated_at": "2025-11-25T10:54:51.800Z"
    },
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "document_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "changes": {
          "total_price_excl_tax": [
            "247.93",
            "16.53"
          ],
          "total_price_excl_tax_base": [
            "247.93",
            "16.53"
          ],
          "total_price_incl_tax": [
            "300.0",
            "20.0"
          ],
          "total_price_incl_tax_base": [
            "300.0",
            "20.0"
          ],
          "cached_taxes": [
            [
              {
                "tax_rate_id": "471699736836965514",
                "report_reference": "NL/5b",
                "payable": false,
                "debit": "52.07",
                "credit": 0
              }
            ],
            [
              {
                "tax_rate_id": "471699736836965514",
                "report_reference": "NL/5b",
                "payable": false,
                "debit": "3.47",
                "credit": 0
              }
            ]
          ],
          "updated_at": [
            "2025-11-25T11:54:51.798+01:00",
            "2025-11-25T11:54:51.867+01:00"
          ]
        }
      },
      "created_at": "2025-11-25T10:54:51.873Z",
      "updated_at": "2025-11-25T10:54:51.873Z"
    }
  ]
}

json

application/json

Destroys note from entity

DELETE

https://moneybird.com/api/v2

/{administration_id}/documents/receipts/{receipt_id}/notes/{id}{format}

Deletes a note from the receipt.

Destroys note from entity › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

receipt_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/receipts/{receipt_id}/notes/{id}{format}

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/documents/receipts/:receipt_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/receipts/{receipt_id}/notes{format}

Adds a note to the receipt.

Adds note to entity › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

receipt_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/receipts/{receipt_id}/notes{format}

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

shell

Example Request Body

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

json

application/json

Example Responses

{
  "id": "471699883208738381",
  "administration_id": 123,
  "entity_id": "471699883135338041",
  "entity_type": "Document",
  "user_id": 17640679459010,
  "assignee_id": "471699883190912587",
  "todo": true,
  "note": "Text of the note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2025-11-25T10:54:45.389Z",
  "updated_at": "2025-11-25T10:54:45.389Z"
}

json

application/json

List receipts

GET

https://moneybird.com/api/v2

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

List receipts › 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 receipts › 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

List receipts › Responses

A list of receipts

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer | null · 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

currency

string | null

revenue_invoice

boolean | null

prices_are_incl_tax

boolean | null

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

paid_at

string | null · date

tax_number

string | null

total_price_excl_tax

string | null

total_price_excl_tax_base

string | null

total_price_incl_tax

string | null

total_price_incl_tax_base

string | null

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

GET/{administration_id}/documents/receipts{format}

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

shell

Example Responses

[
  {
    "id": "471699886540064618",
    "administration_id": 123,
    "contact_id": "471699886364952387",
    "contact": {
      "id": "471699886364952387",
      "administration_id": 123,
      "company_name": "Foobar Holding B.V.",
      "firstname": "",
      "lastname": "",
      "address1": "Hoofdstraat 12",
      "address2": "",
      "zipcode": "1234AB",
      "city": "Amsterdam",
      "country": "NL",
      "phone": "",
      "delivery_method": "Email",
      "customer_id": "1",
      "tax_number": "",
      "chamber_of_commerce": "",
      "bank_account": "",
      "is_trusted": false,
      "max_transfer_amount": null,
      "attention": "",
      "email": "info@example.com",
      "email_ubl": true,
      "send_invoices_to_attention": "",
      "send_invoices_to_email": "info@example.com",
      "send_estimates_to_attention": "",
      "send_estimates_to_email": "info@example.com",
      "sepa_active": false,
      "sepa_iban": "",
      "sepa_iban_account_name": "",
      "sepa_bic": "",
      "sepa_mandate_id": "",
      "sepa_mandate_date": null,
      "sepa_sequence_type": "RCUR",
      "credit_card_number": "",
      "credit_card_reference": "",
      "credit_card_type": null,
      "tax_number_validated_at": null,
      "tax_number_valid": null,
      "invoice_workflow_id": null,
      "estimate_workflow_id": null,
      "si_identifier": "",
      "si_identifier_type": null,
      "moneybird_payments_mandate": false,
      "created_at": "2025-11-25T10:54:48.398Z",
      "updated_at": "2025-11-25T10:54:48.398Z",
      "version": 1764068088,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/fecbdc74581df1b68e29fd912e46b90800928b1cfa906427f930f14d4beab2a3/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "reference": "Lunch supermarket",
    "date": "2025-11-25",
    "due_date": null,
    "entry_number": 5,
    "state": "open",
    "currency": "EUR",
    "exchange_rate": "1.0",
    "revenue_invoice": false,
    "prices_are_incl_tax": true,
    "origin": null,
    "paid_at": null,
    "tax_number": "",
    "total_price_excl_tax": "247.93",
    "total_price_excl_tax_base": "247.93",
    "total_price_incl_tax": "300.0",
    "total_price_incl_tax_base": "300.0",
    "created_at": "2025-11-25T10:54:48.565Z",
    "updated_at": "2025-11-25T10:54:48.569Z",
    "version": 1764068088,
    "details": [
      {
        "id": "471699886542161771",
        "administration_id": 123,
        "tax_rate_id": "471699736836965514",
        "ledger_account_id": "471699736746787958",
        "project_id": null,
        "product_id": null,
        "amount": null,
        "amount_decimal": "1.0",
        "description": "Delivery Apple iPad",
        "price": "300.0",
        "period": null,
        "row_order": 0,
        "total_price_excl_tax_with_discount": "247.93",
        "total_price_excl_tax_with_discount_base": "247.93",
        "tax_report_reference": [
          "NL/5b"
        ],
        "mandatory_tax_text": null,
        "created_at": "2025-11-25T10:54:48.567Z",
        "updated_at": "2025-11-25T10:54:48.567Z"
      }
    ],
    "payments": [],
    "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:54:48.570Z",
        "updated_at": "2025-11-25T10:54:48.570Z"
      }
    ]
  }
]

json

application/json

Create a new receipt

POST

https://moneybird.com/api/v2

/{administration_id}/documents/receipts{format}

Creates a new receipt.

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

object

Create a new receipt › Responses

Receipt created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer | null · 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

currency

string | null

revenue_invoice

boolean | null

prices_are_incl_tax

boolean | null

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

paid_at

string | null · date

tax_number

string | null

total_price_excl_tax

string | null

total_price_excl_tax_base

string | null

total_price_incl_tax

string | null

total_price_incl_tax_base

string | null

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

POST/{administration_id}/documents/receipts{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/documents/receipts:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "receipt": {
    "reference": "foobar",
    "contact_id": 471699887952495740,
    "details_attributes": {
      "0": {
        "description": "Lunch",
        "price": 20,
        "tax_rate_id": 471699736836965500,
        "ledger_account_id": 471699736746788000
      }
    }
  }
}
'

shell

Example Request Body

{
  "receipt": {
    "reference": "foobar",
    "contact_id": 471699887952495740,
    "details_attributes": {
      "0": {
        "description": "Lunch",
        "price": 20,
        "tax_rate_id": 471699736836965500,
        "ledger_account_id": 471699736746788000
      }
    }
  }
}

json

application/json

Example Responses

{
  "id": "471699888060499122",
  "administration_id": 123,
  "contact_id": "471699887952495773",
  "contact": {
    "id": "471699887952495773",
    "administration_id": 123,
    "company_name": "Foobar Holding B.V.",
    "firstname": "",
    "lastname": "",
    "address1": "Hoofdstraat 12",
    "address2": "",
    "zipcode": "1234AB",
    "city": "Amsterdam",
    "country": "NL",
    "phone": "",
    "delivery_method": "Email",
    "customer_id": "1",
    "tax_number": "",
    "chamber_of_commerce": "",
    "bank_account": "",
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": "",
    "email": "info@example.com",
    "email_ubl": true,
    "send_invoices_to_attention": "",
    "send_invoices_to_email": "info@example.com",
    "send_estimates_to_attention": "",
    "send_estimates_to_email": "info@example.com",
    "sepa_active": false,
    "sepa_iban": "",
    "sepa_iban_account_name": "",
    "sepa_bic": "",
    "sepa_mandate_id": "",
    "sepa_mandate_date": null,
    "sepa_sequence_type": "RCUR",
    "credit_card_number": "",
    "credit_card_reference": "",
    "credit_card_type": null,
    "tax_number_validated_at": null,
    "tax_number_valid": null,
    "invoice_workflow_id": null,
    "estimate_workflow_id": null,
    "si_identifier": "",
    "si_identifier_type": null,
    "moneybird_payments_mandate": false,
    "created_at": "2025-11-25T10:54:49.912Z",
    "updated_at": "2025-11-25T10:54:49.912Z",
    "version": 1764068089,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/208ce31823d0152501e13890ec7d22365b76a354761aa96a987ac86ee2f4df29/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "reference": "foobar",
  "date": "2025-11-25",
  "due_date": null,
  "entry_number": 3,
  "state": "open",
  "currency": "EUR",
  "exchange_rate": "1.0",
  "revenue_invoice": false,
  "prices_are_incl_tax": true,
  "origin": null,
  "paid_at": null,
  "tax_number": "",
  "total_price_excl_tax": "16.53",
  "total_price_excl_tax_base": "16.53",
  "total_price_incl_tax": "20.0",
  "total_price_incl_tax_base": "20.0",
  "created_at": "2025-11-25T10:54:50.015Z",
  "updated_at": "2025-11-25T10:54:50.018Z",
  "version": 1764068090,
  "details": [
    {
      "id": "471699888061547699",
      "administration_id": 123,
      "tax_rate_id": "471699736836965514",
      "ledger_account_id": "471699736746787958",
      "project_id": null,
      "product_id": null,
      "amount": null,
      "amount_decimal": "1.0",
      "description": "Lunch",
      "price": "20.0",
      "period": null,
      "row_order": 0,
      "total_price_excl_tax_with_discount": "16.53",
      "total_price_excl_tax_with_discount_base": "16.53",
      "tax_report_reference": [
        "NL/5b"
      ],
      "mandatory_tax_text": null,
      "created_at": "2025-11-25T10:54:50.017Z",
      "updated_at": "2025-11-25T10:54:50.017Z"
    }
  ],
  "payments": [],
  "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:54:50.020Z",
      "updated_at": "2025-11-25T10:54:50.020Z"
    }
  ]
}

json

application/json

Documents: Purchase invoices Documents: Typeless documents