Moneybird API

Estimates

Endpointhttps://moneybird.com/api/v2

Estimates (or quotes) are proposals for products or services that you can send to your clients.

Get an estimate by estimate_id

GET

https://moneybird.com/api/v2

/{administration_id}/estimates/find_by_estimate_id/{estimate_id}{format}

Returns all information about an estimate with the given estimate id

Get an estimate by estimate_id › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

estimate_id

string · required

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 an estimate by estimate_id › Responses

An estimate

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_person_id

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

A unique record identifier

estimate_id

string | null

estimate_sequence_id

string | null

workflow_id

string | integer · pattern: ^\d+$

A unique record identifier

document_style_id

string | integer · pattern: ^\d+$

A unique record identifier

identity_id

string | integer · pattern: ^\d+$

A unique record identifier

draft_id

integer | null

state

string · enum

Enum values:

draft

open

late

accepted

rejected

billed

archived

estimate_date

string | null · date

due_date

string · date

reference

string | null

language

string | null

currency

string

original_estimate_id

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

A unique record identifier

show_tax

boolean

Default: true

sign_online

boolean

Default: true

sent_at

string | null · date

accepted_at

string | null · date

rejected_at

string | null · date

archived_at

string | null · date

created_at

string | null · date-time

updated_at

string | null · date-time

public_view_code

string | null · pattern: ^\d+$

public_view_code_expires_at

string | null · date-time

version

integer

pre_text

string | null

post_text

string | null

object[]

prices_are_incl_tax

boolean

Default: false

url

string

object[]

GET/{administration_id}/estimates/find_by_estimate_id/{estimate_id}{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/estimates/find_by_estimate_id/:estimate_id:format

shell

Example Responses

{
  "id": "471700001359135777",
  "administration_id": 123,
  "contact_id": "471700001310901275",
  "contact": {
    "id": "471700001310901275",
    "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:56:38.019Z",
    "updated_at": "2025-11-25T10:56:38.019Z",
    "version": 1764068198,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/4ccf7cf58a000e0e4e15125f473754635eff0b2587e6383cecc7164257b98bf0/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "contact_person_id": "471700001319289886",
  "contact_person": {
    "id": null,
    "contact_id": "471700001310901275",
    "administration_id": 123,
    "firstname": "Jan",
    "lastname": "Janssen",
    "phone": "123-456-2346",
    "email": "janjanssen@dev.null.moneybird.net",
    "department": "Sales",
    "created_at": "2025-11-25T10:56:38.027Z",
    "updated_at": "2025-11-25T10:56:38.027Z",
    "version": 1764068198
  },
  "estimate_id": "2025-0001",
  "estimate_sequence_id": "0001",
  "workflow_id": "471699737245910162",
  "document_style_id": "471699737325601942",
  "identity_id": "471699736591598698",
  "draft_id": null,
  "state": "open",
  "estimate_date": "2025-11-25",
  "due_date": "2025-12-09",
  "reference": "Project X",
  "language": "nl",
  "currency": "EUR",
  "exchange_rate": "1.0",
  "discount": "0.0",
  "original_estimate_id": null,
  "show_tax": true,
  "sign_online": true,
  "sent_at": "2025-11-25",
  "accepted_at": null,
  "rejected_at": null,
  "archived_at": null,
  "created_at": "2025-11-25T10:56:38.065Z",
  "updated_at": "2025-11-25T10:56:38.146Z",
  "public_view_code": "041810",
  "public_view_code_expires_at": "2026-02-25T10:56:38.115Z",
  "version": 1764068198,
  "pre_text": "Hello, here is your quote",
  "post_text": "Please sign it",
  "details": [
    {
      "id": "471700001362281506",
      "administration_id": 123,
      "tax_rate_id": "471699736823334023",
      "ledger_account_id": "471699736746787959",
      "project_id": null,
      "product_id": null,
      "amount": "1 x",
      "amount_decimal": "1.0",
      "description": "Project X",
      "price": "300.0",
      "period": null,
      "row_order": 1,
      "total_price_excl_tax_with_discount": "300.0",
      "total_price_excl_tax_with_discount_base": "300.0",
      "tax_report_reference": [
        "NL/1a"
      ],
      "mandatory_tax_text": null,
      "created_at": "2025-11-25T10:56:38.068Z",
      "updated_at": "2025-11-25T10:56:38.145Z",
      "is_optional": false,
      "is_selected": true
    }
  ],
  "prices_are_incl_tax": false,
  "total_price_excl_tax": "300.0",
  "total_price_excl_tax_base": "300.0",
  "total_price_incl_tax": "363.0",
  "total_price_incl_tax_base": "363.0",
  "total_discount": "0.0",
  "url": "http://moneybird.dev/123/external/4ccf7cf58a000e0e4e15125f473754635eff0b2587e6383cecc7164257b98bf0/a0ad8cf502df1221332b49ef8cf99059a89d597a26356009664ac8a1842b3138/estimate",
  "custom_fields": [],
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "estimate_send_email",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "email_address": "info@example.com; janjanssen@dev.null.moneybird.net",
        "email_message": "Geachte Jan Janssen,\n\nHierbij ontvangt u van ons een prijsopgave 2025-0001 voor onze\ndiensten.\n\nMet vriendelijke groet,\n\nParkietje B.V."
      },
      "created_at": "2025-11-25T10:56:38.154Z",
      "updated_at": "2025-11-25T10:56:38.154Z"
    },
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "estimate_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:56:38.074Z",
      "updated_at": "2025-11-25T10:56:38.074Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "471699736823334023",
      "taxable_amount": "300.0",
      "taxable_amount_base": "300.0",
      "tax_amount": "63.0",
      "tax_amount_base": "63.0"
    }
  ]
}

json

application/json

List all ids and versions

GET

https://moneybird.com/api/v2

/{administration_id}/estimates/synchronization{format}

Returns all estimates in the administration. The list contains the id and version of the estimate. If the version of the estimate is newer than the version you have stored locally, use the POST variant to fetch estimates with the given ids.

List all ids and versions › 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 all ids and versions › query Parameters

filter

string

List all ids and versions › Responses

200

IDs and versions of records

object[]

id

integer | string

version

integer | string

GET/{administration_id}/estimates/synchronization{format}

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

shell

Example Responses

[
  {
    "id": "471699996828239614",
    "version": 1764068193
  },
  {
    "id": "471699996725479161",
    "version": 1764068193
  }
]

json

application/json

Fetch estimates with given ids

POST

https://moneybird.com/api/v2

/{administration_id}/estimates/synchronization{format}

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

Fetch estimates 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 estimates with given ids › Request Body

ids

(integer | string)[] · required

Fetch estimates with given ids › Responses

A list of estimates

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_person_id

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

A unique record identifier

estimate_id

string | null

estimate_sequence_id

string | null

workflow_id

string | integer · pattern: ^\d+$

A unique record identifier

document_style_id

string | integer · pattern: ^\d+$

A unique record identifier

identity_id

string | integer · pattern: ^\d+$

A unique record identifier

draft_id

integer | null

state

string · enum

Enum values:

draft

open

late

accepted

rejected

billed

archived

estimate_date

string | null · date

due_date

string · date

reference

string | null

language

string | null

currency

string

original_estimate_id

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

A unique record identifier

show_tax

boolean

Default: true

sign_online

boolean

Default: true

sent_at

string | null · date

accepted_at

string | null · date

rejected_at

string | null · date

archived_at

string | null · date

created_at

string | null · date-time

updated_at

string | null · date-time

public_view_code

string | null · pattern: ^\d+$

public_view_code_expires_at

string | null · date-time

version

integer

pre_text

string | null

post_text

string | null

object[]

prices_are_incl_tax

boolean

Default: false

url

string

object[]

POST/{administration_id}/estimates/synchronization{format}

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

shell

Example Request Body

{
  "ids": [
    471699994481526340,
    471699994387154500
  ]
}

json

application/json

Example Responses

[
  {
    "id": "471699994481526350",
    "administration_id": 123,
    "contact_id": "471699994346260035",
    "contact": {
      "id": "471699994346260035",
      "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:56:31.377Z",
      "updated_at": "2025-11-25T10:56:31.377Z",
      "version": 1764068191,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/fd167c84468346d1f90cbbdd9fea9feb3b149d67ac3a885c93c85d47d3164c58/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [
        {
          "id": "471699994354648646",
          "contact_id": "471699994346260035",
          "administration_id": 123,
          "firstname": "Jan",
          "lastname": "Janssen",
          "phone": "123-456-2346",
          "email": "janjanssen@dev.null.moneybird.net",
          "department": "Sales",
          "created_at": "2025-11-25T10:56:31.386Z",
          "updated_at": "2025-11-25T10:56:31.386Z",
          "version": 1764068191
        }
      ],
      "archived": false
    },
    "contact_person_id": null,
    "contact_person": null,
    "estimate_id": null,
    "estimate_sequence_id": null,
    "workflow_id": "471699737245910162",
    "document_style_id": "471699737325601942",
    "identity_id": "471699736591598698",
    "draft_id": 2,
    "state": "draft",
    "estimate_date": null,
    "due_date": "2025-12-09",
    "reference": "Project X",
    "language": "nl",
    "currency": "EUR",
    "exchange_rate": "1.0",
    "discount": "0.0",
    "original_estimate_id": null,
    "show_tax": true,
    "sign_online": true,
    "sent_at": null,
    "accepted_at": null,
    "rejected_at": null,
    "archived_at": null,
    "created_at": "2025-11-25T10:56:31.506Z",
    "updated_at": "2025-11-25T10:56:31.510Z",
    "public_view_code": null,
    "public_view_code_expires_at": null,
    "version": 1764068191,
    "pre_text": "Hello, here is your quote",
    "post_text": "Please sign it",
    "details": [
      {
        "id": "471699994483623503",
        "administration_id": 123,
        "tax_rate_id": "471699736823334023",
        "ledger_account_id": "471699736746787959",
        "project_id": null,
        "product_id": null,
        "amount": "1 x",
        "amount_decimal": "1.0",
        "description": "Project X",
        "price": "300.0",
        "period": null,
        "row_order": 1,
        "total_price_excl_tax_with_discount": "300.0",
        "total_price_excl_tax_with_discount_base": "300.0",
        "tax_report_reference": [
          "NL/1a"
        ],
        "mandatory_tax_text": null,
        "created_at": "2025-11-25T10:56:31.508Z",
        "updated_at": "2025-11-25T10:56:31.508Z",
        "is_optional": false,
        "is_selected": true
      }
    ],
    "prices_are_incl_tax": false,
    "total_price_excl_tax": "300.0",
    "total_price_excl_tax_base": "300.0",
    "total_price_incl_tax": "363.0",
    "total_price_incl_tax_base": "363.0",
    "total_discount": "0.0",
    "url": "http://moneybird.dev/123/external/fd167c84468346d1f90cbbdd9fea9feb3b149d67ac3a885c93c85d47d3164c58/217185ab2f2cd29e1378733d39ffe9b3368874a69dea4a5ae4b9ad0fa948467b/estimate",
    "custom_fields": [],
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "estimate_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-11-25T10:56:31.513Z",
        "updated_at": "2025-11-25T10:56:31.513Z"
      }
    ],
    "tax_totals": [
      {
        "tax_rate_id": "471699736823334023",
        "taxable_amount": "300.0",
        "taxable_amount_base": "300.0",
        "tax_amount": "63.0",
        "tax_amount_base": "63.0"
      }
    ]
  },
  {
    "id": "471699994387154505",
    "administration_id": 123,
    "contact_id": "471699994346260035",
    "contact": {
      "id": "471699994346260035",
      "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:56:31.377Z",
      "updated_at": "2025-11-25T10:56:31.377Z",
      "version": 1764068191,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/fd167c84468346d1f90cbbdd9fea9feb3b149d67ac3a885c93c85d47d3164c58/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "contact_person_id": "471699994354648646",
    "contact_person": {
      "id": null,
      "contact_id": "471699994346260035",
      "administration_id": 123,
      "firstname": "Jan",
      "lastname": "Janssen",
      "phone": "123-456-2346",
      "email": "janjanssen@dev.null.moneybird.net",
      "department": "Sales",
      "created_at": "2025-11-25T10:56:31.386Z",
      "updated_at": "2025-11-25T10:56:31.386Z",
      "version": 1764068191
    },
    "estimate_id": "2025-0001",
    "estimate_sequence_id": "0001",
    "workflow_id": "471699737245910162",
    "document_style_id": "471699737325601942",
    "identity_id": "471699736591598698",
    "draft_id": null,
    "state": "open",
    "estimate_date": "2025-11-25",
    "due_date": "2025-12-09",
    "reference": "Project X",
    "language": "nl",
    "currency": "EUR",
    "exchange_rate": "1.0",
    "discount": "0.0",
    "original_estimate_id": null,
    "show_tax": true,
    "sign_online": true,
    "sent_at": "2025-11-25",
    "accepted_at": null,
    "rejected_at": null,
    "archived_at": null,
    "created_at": "2025-11-25T10:56:31.416Z",
    "updated_at": "2025-11-25T10:56:31.470Z",
    "public_view_code": "611477",
    "public_view_code_expires_at": "2026-02-25T10:56:31.444Z",
    "version": 1764068191,
    "pre_text": "Hello, here is your quote",
    "post_text": "Please sign it",
    "details": [
      {
        "id": "471699994389251658",
        "administration_id": 123,
        "tax_rate_id": "471699736823334023",
        "ledger_account_id": "471699736746787959",
        "project_id": null,
        "product_id": null,
        "amount": "1 x",
        "amount_decimal": "1.0",
        "description": "Project X",
        "price": "300.0",
        "period": null,
        "row_order": 1,
        "total_price_excl_tax_with_discount": "300.0",
        "total_price_excl_tax_with_discount_base": "300.0",
        "tax_report_reference": [
          "NL/1a"
        ],
        "mandatory_tax_text": null,
        "created_at": "2025-11-25T10:56:31.418Z",
        "updated_at": "2025-11-25T10:56:31.468Z",
        "is_optional": false,
        "is_selected": true
      }
    ],
    "prices_are_incl_tax": false,
    "total_price_excl_tax": "300.0",
    "total_price_excl_tax_base": "300.0",
    "total_price_incl_tax": "363.0",
    "total_price_incl_tax_base": "363.0",
    "total_discount": "0.0",
    "url": "http://moneybird.dev/123/external/fd167c84468346d1f90cbbdd9fea9feb3b149d67ac3a885c93c85d47d3164c58/e38ac8714a5d55b9c6100bed84c3575bd3311cb30b9f1cd0cb1fe66bfdeeaa57/estimate",
    "custom_fields": [],
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "estimate_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-11-25T10:56:31.423Z",
        "updated_at": "2025-11-25T10:56:31.423Z"
      },
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "estimate_send_email",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {
          "email_address": "info@example.com; janjanssen@dev.null.moneybird.net",
          "email_message": "Geachte Jan Janssen,\n\nHierbij ontvangt u van ons een prijsopgave 2025-0001 voor onze\ndiensten.\n\nMet vriendelijke groet,\n\nParkietje B.V."
        },
        "created_at": "2025-11-25T10:56:31.477Z",
        "updated_at": "2025-11-25T10:56:31.477Z"
      }
    ],
    "tax_totals": [
      {
        "tax_rate_id": "471699736823334023",
        "taxable_amount": "300.0",
        "taxable_amount_base": "300.0",
        "tax_amount": "63.0",
        "tax_amount_base": "63.0"
      }
    ]
  }
]

json

application/json

Download attachment

GET

https://moneybird.com/api/v2

/{administration_id}/estimates/{estimate_id}/attachments/{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

estimate_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

Download attachment › Responses

Found

string

GET/{administration_id}/estimates/{estimate_id}/attachments/{id}/download{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/estimates/:estimate_id/attachments/: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}/estimates/{estimate_id}/attachments/{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

estimate_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

Delete an attachment › Responses

Attachment deleted

No data returned

DELETE/{administration_id}/estimates/{estimate_id}/attachments/{id}{format}

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/estimates/:estimate_id/attachments/:id:format

shell

Example Responses

No example specified for this content type

Destroys note from entity

DELETE

https://moneybird.com/api/v2

/{administration_id}/estimates/{estimate_id}/notes/{id}{format}

Deletes a note from the estimate.

Destroys note from entity › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

estimate_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}/estimates/{estimate_id}/notes/{id}{format}

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/estimates/:estimate_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}/estimates/{estimate_id}/notes{format}

Adds a note to the estimate.

Adds note to entity › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

estimate_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}/estimates/{estimate_id}/notes{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/estimates/:estimate_id/notes:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "note": {
    "note": "A pending TODO",
    "assignee_id": 471700001921172540,
    "todo": true
  }
}
'

shell

Example Request Body

{
  "note": {
    "note": "A pending TODO",
    "assignee_id": 471700001921172540,
    "todo": true
  }
}

json

application/json

Example Responses

{
  "id": "471700001938998351",
  "administration_id": 123,
  "entity_id": "471700001845675080",
  "entity_type": "Estimate",
  "user_id": 17640679459010,
  "assignee_id": "471700001921172557",
  "todo": true,
  "note": "A pending TODO",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2025-11-25T10:56:38.618Z",
  "updated_at": "2025-11-25T10:56:38.618Z"
}

json

application/json

Add attachment to estimate

POST

https://moneybird.com/api/v2

/{administration_id}/estimates/{id}/attachments{format}

Add an attachment to an estimate.

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

file

string · binary

Add attachment to estimate › Responses

Status code

integer

POST/{administration_id}/estimates/{id}/attachments{format}

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

shell

Example Request Body

{
  "file": "file"
}

json

Example Responses

json

application/json

Bills an estimate

PATCH

https://moneybird.com/api/v2

/{administration_id}/estimates/{id}/bill_estimate{format}

An invoice is created based on the accepted estimate.

Bills an estimate › 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

Bills an estimate › Request Body

Bills an estimate › Responses

Estimate billed

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer · pattern: ^\d+$

A unique record identifier

object

contact_person_id

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

A unique record identifier

invoice_id

string | null

recurring_sales_invoice_id

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

A unique record identifier

subscription_id

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

A unique record identifier

workflow_id

string | integer · pattern: ^\d+$

A unique record identifier

document_style_id

string | integer · pattern: ^\d+$

A unique record identifier

identity_id

string | integer · pattern: ^\d+$

A unique record identifier

draft_id

integer | null

state

string · enum

Enum values:

draft

scheduled

open

pending_payment

reminded

late

paid

uncollectible

invoice_date

string | null · date

due_date

string · date

payment_conditions

string | null

payment_reference

string | null

short_payment_reference

string | null

reference

string | null

language

string | null

currency

string

discount

string | null

original_sales_invoice_id

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

A unique record identifier

paused

boolean

paid_at

string | null · date

sent_at

string | null · date

created_at

string · date-time

updated_at

string · date-time

public_view_code

string | null

public_view_code_expires_at

string | null · date-time

version

integer

object[]

total_paid

string

total_unpaid

string

total_unpaid_base

string

prices_are_incl_tax

boolean

total_price_excl_tax

string

total_price_excl_tax_base

string

total_price_incl_tax

string

total_price_incl_tax_base

string

total_discount

string

marked_dubious_on

string | null · date

marked_uncollectible_on

string | null · date

reminder_count

integer | null

next_reminder

string | null · date

original_estimate_id

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

A unique record identifier

url

string

payment_url

string

object[]

PATCH/{administration_id}/estimates/{id}/bill_estimate{format}

curl --request PATCH \
  --url https://moneybird.com/api/v2/:administration_id/estimates/:id/bill_estimate:format \
  --header 'Content-Type: application/json' \
  --data '{}'

shell

Example Request Body

{}

json

application/json

Example Responses

{
  "id": "471699995666417320",
  "administration_id": 123,
  "contact_id": "471699995405321879",
  "contact": {
    "id": "471699995405321879",
    "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:56:32.387Z",
    "updated_at": "2025-11-25T10:56:32.387Z",
    "version": 1764068192,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/f57ae1f974ed5a9a0ae9ad171afa0c507b4d17db20a13b678789925b0e9d10be/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [
      {
        "id": "471699995413710490",
        "contact_id": "471699995405321879",
        "administration_id": 123,
        "firstname": "Jan",
        "lastname": "Janssen",
        "phone": "123-456-2346",
        "email": "janjanssen@dev.null.moneybird.net",
        "department": "Sales",
        "created_at": "2025-11-25T10:56:32.396Z",
        "updated_at": "2025-11-25T10:56:32.396Z",
        "version": 1764068192
      }
    ],
    "archived": false
  },
  "contact_person_id": null,
  "contact_person": null,
  "invoice_id": null,
  "recurring_sales_invoice_id": null,
  "subscription_id": null,
  "workflow_id": "471699737092818060",
  "document_style_id": "471699737325601942",
  "identity_id": "471699736591598698",
  "draft_id": 1,
  "state": "draft",
  "invoice_date": null,
  "due_date": "2025-12-09",
  "payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
  "payment_reference": null,
  "short_payment_reference": null,
  "reference": "Project X",
  "language": "nl",
  "currency": "EUR",
  "discount": "0.0",
  "original_sales_invoice_id": null,
  "paused": false,
  "paid_at": null,
  "sent_at": null,
  "created_at": "2025-11-25T10:56:32.636Z",
  "updated_at": "2025-11-25T10:56:32.641Z",
  "public_view_code": null,
  "public_view_code_expires_at": null,
  "version": 1764068192,
  "details": [
    {
      "id": "471699995669563049",
      "administration_id": 123,
      "tax_rate_id": "471699736823334023",
      "ledger_account_id": "471699736746787959",
      "project_id": null,
      "product_id": null,
      "amount": "1 x",
      "amount_decimal": "1.0",
      "description": "Project X",
      "price": "300.0",
      "period": null,
      "row_order": 1,
      "total_price_excl_tax_with_discount": "300.0",
      "total_price_excl_tax_with_discount_base": "300.0",
      "tax_report_reference": [
        "NL/1a"
      ],
      "mandatory_tax_text": null,
      "created_at": "2025-11-25T10:56:32.639Z",
      "updated_at": "2025-11-25T10:56:32.639Z"
    }
  ],
  "payments": [],
  "total_paid": "0.0",
  "total_unpaid": "363.0",
  "total_unpaid_base": "363.0",
  "prices_are_incl_tax": false,
  "total_price_excl_tax": "300.0",
  "total_price_excl_tax_base": "300.0",
  "total_price_incl_tax": "363.0",
  "total_price_incl_tax_base": "363.0",
  "total_discount": "0.0",
  "marked_dubious_on": null,
  "marked_uncollectible_on": null,
  "reminder_count": 0,
  "next_reminder": null,
  "original_estimate_id": "471699995538491042",
  "url": "http://moneybird.dev/123/external/f57ae1f974ed5a9a0ae9ad171afa0c507b4d17db20a13b678789925b0e9d10be/80857941e3d4c10aec083002f87382aecf082c8307eda45a81800634205b21d7/sales_invoice",
  "payment_url": "http://moneybird.dev/123/external/f57ae1f974ed5a9a0ae9ad171afa0c507b4d17db20a13b678789925b0e9d10be/80857941e3d4c10aec083002f87382aecf082c8307eda45a81800634205b21d7/sales_invoice",
  "custom_fields": [],
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "sales_invoice_created_based_on_estimate",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "original_estimate": "2025-0002"
      },
      "created_at": "2025-11-25T10:56:32.644Z",
      "updated_at": "2025-11-25T10:56:32.644Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "471699736823334023",
      "taxable_amount": "300.0",
      "taxable_amount_base": "300.0",
      "tax_amount": "63.0",
      "tax_amount_base": "63.0"
    }
  ],
  "time_entries": []
}

json

application/json

Changes the state of an estimate

PATCH

https://moneybird.com/api/v2

/{administration_id}/estimates/{id}/change_state{format}

Not every state change is allowed. e.g. open to billed is accepted, draft to open is not. Note: this only changes the state and does not perform other actions like sending or billing the estimate.

Changes the state of an estimate › 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

Changes the state of an estimate › Request Body

state

string · required

Can be accepted, rejected, open, late, billed or archived.

Changes the state of an estimate › Responses

Estimate updated

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_person_id

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

A unique record identifier

estimate_id

string | null

estimate_sequence_id

string | null

workflow_id

string | integer · pattern: ^\d+$

A unique record identifier

document_style_id

string | integer · pattern: ^\d+$

A unique record identifier

identity_id

string | integer · pattern: ^\d+$

A unique record identifier

draft_id

integer | null

state

string · enum

Enum values:

draft

open

late

accepted

rejected

billed

archived

estimate_date

string | null · date

due_date

string · date

reference

string | null

language

string | null

currency

string

original_estimate_id

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

A unique record identifier

show_tax

boolean

Default: true

sign_online

boolean

Default: true

sent_at

string | null · date

accepted_at

string | null · date

rejected_at

string | null · date

archived_at

string | null · date

created_at

string | null · date-time

updated_at

string | null · date-time

public_view_code

string | null · pattern: ^\d+$

public_view_code_expires_at

string | null · date-time

version

integer

pre_text

string | null

post_text

string | null

object[]

prices_are_incl_tax

boolean

Default: false

url

string

object[]

PATCH/{administration_id}/estimates/{id}/change_state{format}

curl --request PATCH \
  --url https://moneybird.com/api/v2/:administration_id/estimates/:id/change_state:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "state": "accepted"
}
'

shell

Example Request Body

{
  "state": "accepted"
}

json

application/json

Example Responses

{
  "id": "471700000352503763",
  "administration_id": 123,
  "contact_id": "471700000214091720",
  "contact": {
    "id": "471700000214091720",
    "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:56:36.973Z",
    "updated_at": "2025-11-25T10:56:36.973Z",
    "version": 1764068196,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/bc40c99b040bf49997c318245a12d978bc3297898ec3cb30c242db3dcd5595f7/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "contact_person_id": null,
  "contact_person": null,
  "estimate_id": "2025-0002",
  "estimate_sequence_id": "0002",
  "workflow_id": "471699737245910162",
  "document_style_id": "471699737325601942",
  "identity_id": "471699736591598698",
  "draft_id": null,
  "state": "accepted",
  "estimate_date": "2025-11-25",
  "due_date": "2025-12-09",
  "reference": "Project X",
  "language": "nl",
  "currency": "EUR",
  "exchange_rate": "1.0",
  "discount": "0.0",
  "original_estimate_id": null,
  "show_tax": true,
  "sign_online": true,
  "sent_at": "2025-11-25",
  "accepted_at": "2025-11-25",
  "rejected_at": null,
  "archived_at": null,
  "created_at": "2025-11-25T10:56:37.105Z",
  "updated_at": "2025-11-25T10:56:37.187Z",
  "public_view_code": "169563",
  "public_view_code_expires_at": "2026-02-25T10:56:37.135Z",
  "version": 1764068197,
  "pre_text": "Hello, here is your quote",
  "post_text": "Please sign it",
  "details": [
    {
      "id": "471700000354600916",
      "administration_id": 123,
      "tax_rate_id": "471699736823334023",
      "ledger_account_id": "471699736746787959",
      "project_id": null,
      "product_id": null,
      "amount": "1 x",
      "amount_decimal": "1.0",
      "description": "Project X",
      "price": "300.0",
      "period": null,
      "row_order": 1,
      "total_price_excl_tax_with_discount": "300.0",
      "total_price_excl_tax_with_discount_base": "300.0",
      "tax_report_reference": [
        "NL/1a"
      ],
      "mandatory_tax_text": null,
      "created_at": "2025-11-25T10:56:37.107Z",
      "updated_at": "2025-11-25T10:56:37.158Z",
      "is_optional": false,
      "is_selected": true
    }
  ],
  "prices_are_incl_tax": false,
  "total_price_excl_tax": "300.0",
  "total_price_excl_tax_base": "300.0",
  "total_price_incl_tax": "363.0",
  "total_price_incl_tax_base": "363.0",
  "total_discount": "0.0",
  "url": "http://moneybird.dev/123/external/bc40c99b040bf49997c318245a12d978bc3297898ec3cb30c242db3dcd5595f7/9c4d2039a26857997f0a58ae107c17aef2fb1acf205e97b0a5cf8b56d2925c71/estimate",
  "custom_fields": [],
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "estimate_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:56:37.112Z",
      "updated_at": "2025-11-25T10:56:37.112Z"
    },
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "estimate_send_email",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "email_address": "info@example.com",
        "email_message": "Geachte Foobar Holding B.V.,\n\nHierbij ontvangt u van ons een prijsopgave 2025-0002 voor onze\ndiensten.\n\nMet vriendelijke groet,\n\nParkietje B.V."
      },
      "created_at": "2025-11-25T10:56:37.167Z",
      "updated_at": "2025-11-25T10:56:37.167Z"
    },
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "estimate_mark_accepted",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:56:37.190Z",
      "updated_at": "2025-11-25T10:56:37.190Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "471699736823334023",
      "taxable_amount": "300.0",
      "taxable_amount_base": "300.0",
      "tax_amount": "63.0",
      "tax_amount_base": "63.0"
    }
  ]
}

json

application/json

Download estimate PDF by id

GET

https://moneybird.com/api/v2

/{administration_id}/estimates/{id}/download_pdf{format}

Redirects to the download URL of the estimate as PDF. The link is valid for 30 seconds.

Download estimate PDF by id › 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

Download estimate PDF by id › query Parameters

media

string

In case you want to hide sender address and logo you can set this to 'stationery'.

Download estimate PDF by id › Responses

Found

string

GET/{administration_id}/estimates/{id}/download_pdf{format}

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

shell

Example Responses

"This resource has been moved temporarily to http://moneybird-storage:3100/6c0f1176b28085ced5e9cee3421ab5e0cce99cb8519983f29edaf763d669369f/b3fc594a0d4bd256eed3483fa29707831599ce2dc578fe23847319d1a1ad30c7/download."

plain

text/plain

Sends an estimate

PATCH

https://moneybird.com/api/v2

/{administration_id}/estimates/{id}/send_estimate{format}

You can provide a send method, email address and message. If you don't provide any arguments, the defaults from the contact and workflow will be used.

Sends an estimate › 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

Sends an estimate › Request Body

object

sender

boolean | string

signature_output

string

audit_trail

string

ip_address

string

Sends an estimate › Responses

Estimate updated

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_person_id

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

A unique record identifier

estimate_id

string | null

estimate_sequence_id

string | null

workflow_id

string | integer · pattern: ^\d+$

A unique record identifier

document_style_id

string | integer · pattern: ^\d+$

A unique record identifier

identity_id

string | integer · pattern: ^\d+$

A unique record identifier

draft_id

integer | null

state

string · enum

Enum values:

draft

open

late

accepted

rejected

billed

archived

estimate_date

string | null · date

due_date

string · date

reference

string | null

language

string | null

currency

string

original_estimate_id

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

A unique record identifier

show_tax

boolean

Default: true

sign_online

boolean

Default: true

sent_at

string | null · date

accepted_at

string | null · date

rejected_at

string | null · date

archived_at

string | null · date

created_at

string | null · date-time

updated_at

string | null · date-time

public_view_code

string | null · pattern: ^\d+$

public_view_code_expires_at

string | null · date-time

version

integer

pre_text

string | null

post_text

string | null

object[]

prices_are_incl_tax

boolean

Default: false

url

string

object[]

PATCH/{administration_id}/estimates/{id}/send_estimate{format}

curl --request PATCH \
  --url https://moneybird.com/api/v2/:administration_id/estimates/:id/send_estimate:format \
  --header 'Content-Type: application/json' \
  --data '{}'

shell

Example Request Body

{}

json

application/json

Example Responses

{
  "id": "471699988710163647",
  "administration_id": 123,
  "contact_id": "471699988676609212",
  "contact": {
    "id": "471699988676609212",
    "administration_id": 123,
    "company_name": "Foobar Holding B.V.",
    "firstname": "",
    "lastname": "",
    "address1": "Hoofdstraat 12",
    "address2": "",
    "zipcode": "1234AB",
    "city": "Amsterdam",
    "country": "NL",
    "phone": "",
    "delivery_method": "Simplerinvoicing",
    "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": "12345678",
    "si_identifier_type": "NL:KVK",
    "moneybird_payments_mandate": false,
    "created_at": "2025-11-25T10:56:25.970Z",
    "updated_at": "2025-11-25T10:56:26.015Z",
    "version": 1764068186,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/bee57f79edad3be60b602595c272d7e12eca5f991ce640ca3477e1473aa2800b/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "contact_person_id": null,
  "contact_person": null,
  "estimate_id": "2025-0001",
  "estimate_sequence_id": "0001",
  "workflow_id": "471699737245910162",
  "document_style_id": "471699737325601942",
  "identity_id": "471699736591598698",
  "draft_id": null,
  "state": "open",
  "estimate_date": "2025-11-25",
  "due_date": "2025-12-09",
  "reference": "Project X",
  "language": "nl",
  "currency": "EUR",
  "exchange_rate": "1.0",
  "discount": "0.0",
  "original_estimate_id": null,
  "show_tax": true,
  "sign_online": true,
  "sent_at": "2025-11-25",
  "accepted_at": null,
  "rejected_at": null,
  "archived_at": null,
  "created_at": "2025-11-25T10:56:26.003Z",
  "updated_at": "2025-11-25T10:56:26.066Z",
  "public_view_code": "772435",
  "public_view_code_expires_at": "2026-02-25T10:56:26.041Z",
  "version": 1764068186,
  "pre_text": "Hello, here is your quote",
  "post_text": "Please sign it",
  "details": [
    {
      "id": "471699988712260800",
      "administration_id": 123,
      "tax_rate_id": "471699736823334023",
      "ledger_account_id": "471699736746787959",
      "project_id": null,
      "product_id": null,
      "amount": "1 x",
      "amount_decimal": "1.0",
      "description": "Project X",
      "price": "300.0",
      "period": null,
      "row_order": 1,
      "total_price_excl_tax_with_discount": "300.0",
      "total_price_excl_tax_with_discount_base": "300.0",
      "tax_report_reference": [
        "NL/1a"
      ],
      "mandatory_tax_text": null,
      "created_at": "2025-11-25T10:56:26.005Z",
      "updated_at": "2025-11-25T10:56:26.065Z",
      "is_optional": false,
      "is_selected": true
    }
  ],
  "prices_are_incl_tax": false,
  "total_price_excl_tax": "300.0",
  "total_price_excl_tax_base": "300.0",
  "total_price_incl_tax": "363.0",
  "total_price_incl_tax_base": "363.0",
  "total_discount": "0.0",
  "url": "http://moneybird.dev/123/external/bee57f79edad3be60b602595c272d7e12eca5f991ce640ca3477e1473aa2800b/53cbac8161a79974dc386364a7334b319e9c6611f9d13a8cdbe916bcc3eb1b6c/estimate",
  "custom_fields": [],
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "estimate_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:56:26.009Z",
      "updated_at": "2025-11-25T10:56:26.009Z"
    },
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "estimate_send_email",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "email_address": "info@example.com",
        "email_message": "Geachte Foobar Holding B.V.,\n\nHierbij ontvangt u van ons een prijsopgave 2025-0001 voor onze\ndiensten.\n\nMet vriendelijke groet,\n\nParkietje B.V."
      },
      "created_at": "2025-11-25T10:56:26.073Z",
      "updated_at": "2025-11-25T10:56:26.073Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "471699736823334023",
      "taxable_amount": "300.0",
      "taxable_amount_base": "300.0",
      "tax_amount": "63.0",
      "tax_amount_base": "63.0"
    }
  ]
}

json

application/json

Get an estimate by id

GET

https://moneybird.com/api/v2

/{administration_id}/estimates/{id}{format}

Returns all information about an estimate.

Get an estimate by id › 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 an estimate by id › query Parameters

includes

string[]

Get an estimate by id › Responses

A estimate

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_person_id

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

A unique record identifier

estimate_id

string | null

estimate_sequence_id

string | null

workflow_id

string | integer · pattern: ^\d+$

A unique record identifier

document_style_id

string | integer · pattern: ^\d+$

A unique record identifier

identity_id

string | integer · pattern: ^\d+$

A unique record identifier

draft_id

integer | null

state

string · enum

Enum values:

draft

open

late

accepted

rejected

billed

archived

estimate_date

string | null · date

due_date

string · date

reference

string | null

language

string | null

currency

string

original_estimate_id

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

A unique record identifier

show_tax

boolean

Default: true

sign_online

boolean

Default: true

sent_at

string | null · date

accepted_at

string | null · date

rejected_at

string | null · date

archived_at

string | null · date

created_at

string | null · date-time

updated_at

string | null · date-time

public_view_code

string | null · pattern: ^\d+$

public_view_code_expires_at

string | null · date-time

version

integer

pre_text

string | null

post_text

string | null

object[]

prices_are_incl_tax

boolean

Default: false

url

string

object[]

GET/{administration_id}/estimates/{id}{format}

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

shell

Example Responses

{
  "id": "471699988539245749",
  "administration_id": 123,
  "contact_id": "471699988497302703",
  "contact": {
    "id": "471699988497302703",
    "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:56:25.799Z",
    "updated_at": "2025-11-25T10:56:25.799Z",
    "version": 1764068185,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/82c684c78dcd11d0f4663f05a29769e90f2b18041294ab992338a7cb9eeebd66/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "contact_person_id": "471699988505691314",
  "contact_person": {
    "id": null,
    "contact_id": "471699988497302703",
    "administration_id": 123,
    "firstname": "Jan",
    "lastname": "Janssen",
    "phone": "123-456-2346",
    "email": "janjanssen@dev.null.moneybird.net",
    "department": "Sales",
    "created_at": "2025-11-25T10:56:25.808Z",
    "updated_at": "2025-11-25T10:56:25.808Z",
    "version": 1764068185
  },
  "estimate_id": "2025-0001",
  "estimate_sequence_id": "0001",
  "workflow_id": "471699737245910162",
  "document_style_id": "471699737325601942",
  "identity_id": "471699736591598698",
  "draft_id": null,
  "state": "open",
  "estimate_date": "2025-11-25",
  "due_date": "2025-12-09",
  "reference": "Project X",
  "language": "nl",
  "currency": "EUR",
  "exchange_rate": "1.0",
  "discount": "0.0",
  "original_estimate_id": null,
  "show_tax": true,
  "sign_online": true,
  "sent_at": "2025-11-25",
  "accepted_at": null,
  "rejected_at": null,
  "archived_at": null,
  "created_at": "2025-11-25T10:56:25.839Z",
  "updated_at": "2025-11-25T10:56:25.896Z",
  "public_view_code": "690664",
  "public_view_code_expires_at": "2026-02-25T10:56:25.869Z",
  "version": 1764068185,
  "pre_text": "Hello, here is your quote",
  "post_text": "Please sign it",
  "details": [
    {
      "id": "471699988541342902",
      "administration_id": 123,
      "tax_rate_id": "471699736823334023",
      "ledger_account_id": "471699736746787959",
      "project_id": null,
      "product_id": null,
      "amount": "1 x",
      "amount_decimal": "1.0",
      "description": "Project X",
      "price": "300.0",
      "period": null,
      "row_order": 1,
      "total_price_excl_tax_with_discount": "300.0",
      "total_price_excl_tax_with_discount_base": "300.0",
      "tax_report_reference": [
        "NL/1a"
      ],
      "mandatory_tax_text": null,
      "created_at": "2025-11-25T10:56:25.841Z",
      "updated_at": "2025-11-25T10:56:25.894Z",
      "is_optional": false,
      "is_selected": true
    }
  ],
  "prices_are_incl_tax": false,
  "total_price_excl_tax": "300.0",
  "total_price_excl_tax_base": "300.0",
  "total_price_incl_tax": "363.0",
  "total_price_incl_tax_base": "363.0",
  "total_discount": "0.0",
  "url": "http://moneybird.dev/123/external/82c684c78dcd11d0f4663f05a29769e90f2b18041294ab992338a7cb9eeebd66/8d2e0fc9a118399047a5c534e69172d2ba1b5db70f6eb40ad5611ed61958f4df/estimate",
  "custom_fields": [],
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "estimate_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:56:25.846Z",
      "updated_at": "2025-11-25T10:56:25.846Z"
    },
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "estimate_send_email",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "email_address": "info@example.com; janjanssen@dev.null.moneybird.net",
        "email_message": "Geachte Jan Janssen,\n\nHierbij ontvangt u van ons een prijsopgave 2025-0001 voor onze\ndiensten.\n\nMet vriendelijke groet,\n\nParkietje B.V."
      },
      "created_at": "2025-11-25T10:56:25.903Z",
      "updated_at": "2025-11-25T10:56:25.903Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "471699736823334023",
      "taxable_amount": "300.0",
      "taxable_amount_base": "300.0",
      "tax_amount": "63.0",
      "tax_amount_base": "63.0"
    }
  ]
}

json

application/json

Deletes an estimate

DELETE

https://moneybird.com/api/v2

/{administration_id}/estimates/{id}{format}

Deletes an estimate.

Deletes an estimate › 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

Deletes an estimate › Responses

Estimate deleted

No data returned

DELETE/{administration_id}/estimates/{id}{format}

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

shell

Example Responses

No example specified for this content type

Updates an estimate

PATCH

https://moneybird.com/api/v2

/{administration_id}/estimates/{id}{format}

When updating an estimate, provide only the attributes you want to update. The other attributes will not be changed.

Updates an estimate › 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

Updates an estimate › Request Body

object

Updates an estimate › Responses

Estimate updated

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_person_id

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

A unique record identifier

estimate_id

string | null

estimate_sequence_id

string | null

workflow_id

string | integer · pattern: ^\d+$

A unique record identifier

document_style_id

string | integer · pattern: ^\d+$

A unique record identifier

identity_id

string | integer · pattern: ^\d+$

A unique record identifier

draft_id

integer | null

state

string · enum

Enum values:

draft

open

late

accepted

rejected

billed

archived

estimate_date

string | null · date

due_date

string · date

reference

string | null

language

string | null

currency

string

original_estimate_id

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

A unique record identifier

show_tax

boolean

Default: true

sign_online

boolean

Default: true

sent_at

string | null · date

accepted_at

string | null · date

rejected_at

string | null · date

archived_at

string | null · date

created_at

string | null · date-time

updated_at

string | null · date-time

public_view_code

string | null · pattern: ^\d+$

public_view_code_expires_at

string | null · date-time

version

integer

pre_text

string | null

post_text

string | null

object[]

prices_are_incl_tax

boolean

Default: false

url

string

object[]

PATCH/{administration_id}/estimates/{id}{format}

curl --request PATCH \
  --url https://moneybird.com/api/v2/:administration_id/estimates/:id:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "estimate": {
    "details_attributes": {
      "0": {
        "description": "Detail description",
        "price": 99,
        "amount": 1,
        "tax_rate_id": 471699736823334000,
        "ledger_account_id": 471699736746788000
      },
      "1": {
        "id": 471699994738427500,
        "_destroy": true
      }
    }
  }
}
'

shell

Example Request Body

{
  "estimate": {
    "details_attributes": {
      "0": {
        "description": "Detail description",
        "price": 99,
        "amount": 1,
        "tax_rate_id": 471699736823334000,
        "ledger_account_id": 471699736746788000
      },
      "1": {
        "id": 471699994738427500,
        "_destroy": true
      }
    }
  }
}

json

application/json

Example Responses

{
  "id": "471699994736330342",
  "administration_id": 123,
  "contact_id": "471699994696484448",
  "contact": {
    "id": "471699994696484448",
    "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:56:31.711Z",
    "updated_at": "2025-11-25T10:56:31.711Z",
    "version": 1764068191,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/100a57409c166b38ee79a7f3f805a408e50a93565ec22ee8071f3140e33ce45c/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "contact_person_id": "471699994704873059",
  "contact_person": {
    "id": null,
    "contact_id": "471699994696484448",
    "administration_id": 123,
    "firstname": "Jan",
    "lastname": "Janssen",
    "phone": "123-456-2346",
    "email": "janjanssen@dev.null.moneybird.net",
    "department": "Sales",
    "created_at": "2025-11-25T10:56:31.719Z",
    "updated_at": "2025-11-25T10:56:31.719Z",
    "version": 1764068191
  },
  "estimate_id": "2025-0001",
  "estimate_sequence_id": "0001",
  "workflow_id": "471699737245910162",
  "document_style_id": "471699737325601942",
  "identity_id": "471699736591598698",
  "draft_id": null,
  "state": "open",
  "estimate_date": "2025-11-25",
  "due_date": "2025-12-09",
  "reference": "Project X",
  "language": "nl",
  "currency": "EUR",
  "exchange_rate": "1.0",
  "discount": "0.0",
  "original_estimate_id": null,
  "show_tax": true,
  "sign_online": true,
  "sent_at": "2025-11-25",
  "accepted_at": null,
  "rejected_at": null,
  "archived_at": null,
  "created_at": "2025-11-25T10:56:31.749Z",
  "updated_at": "2025-11-25T10:56:31.865Z",
  "public_view_code": "113675",
  "public_view_code_expires_at": "2026-02-25T10:56:31.777Z",
  "version": 1764068191,
  "pre_text": "Hello, here is your quote",
  "post_text": "Please sign it",
  "details": [
    {
      "id": "471699994855868011",
      "administration_id": 123,
      "tax_rate_id": "471699736823334023",
      "ledger_account_id": "471699736746787959",
      "project_id": null,
      "product_id": null,
      "amount": "1",
      "amount_decimal": "1.0",
      "description": "Detail description",
      "price": "99.0",
      "period": null,
      "row_order": 0,
      "total_price_excl_tax_with_discount": "99.0",
      "total_price_excl_tax_with_discount_base": "99.0",
      "tax_report_reference": [
        "NL/1a"
      ],
      "mandatory_tax_text": null,
      "created_at": "2025-11-25T10:56:31.863Z",
      "updated_at": "2025-11-25T10:56:31.863Z",
      "is_optional": false,
      "is_selected": true
    }
  ],
  "prices_are_incl_tax": false,
  "total_price_excl_tax": "99.0",
  "total_price_excl_tax_base": "99.0",
  "total_price_incl_tax": "119.79",
  "total_price_incl_tax_base": "119.79",
  "total_discount": "0.0",
  "url": "http://moneybird.dev/123/external/100a57409c166b38ee79a7f3f805a408e50a93565ec22ee8071f3140e33ce45c/7d427a8be295a68023d401eebdecc86d7370828078e358509424c0d379d10226/estimate",
  "custom_fields": [],
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "estimate_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:56:31.756Z",
      "updated_at": "2025-11-25T10:56:31.756Z"
    },
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "estimate_send_email",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "email_address": "info@example.com; janjanssen@dev.null.moneybird.net",
        "email_message": "Geachte Jan Janssen,\n\nHierbij ontvangt u van ons een prijsopgave 2025-0001 voor onze\ndiensten.\n\nMet vriendelijke groet,\n\nParkietje B.V."
      },
      "created_at": "2025-11-25T10:56:31.810Z",
      "updated_at": "2025-11-25T10:56:31.810Z"
    },
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "estimate_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "total_price_excl_tax": [
          "300.0",
          "99.0"
        ],
        "total_price_excl_tax_base": [
          "300.0",
          "99.0"
        ],
        "total_price_incl_tax": [
          "363.0",
          "119.79"
        ],
        "total_price_incl_tax_base": [
          "363.0",
          "119.79"
        ],
        "cached_taxes": [
          [
            {
              "tax_rate_id": "471699736823334023",
              "report_reference": "NL/1a",
              "payable": true,
              "debit": 0,
              "credit": "63.0"
            }
          ],
          [
            {
              "tax_rate_id": "471699736823334023",
              "report_reference": "NL/1a",
              "payable": true,
              "debit": 0,
              "credit": "20.79"
            }
          ]
        ],
        "updated_at": [
          "2025-11-25T11:56:31.802+01:00",
          "2025-11-25T11:56:31.857+01:00"
        ]
      },
      "created_at": "2025-11-25T10:56:31.866Z",
      "updated_at": "2025-11-25T10:56:31.866Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "471699736823334023",
      "taxable_amount": "99.0",
      "taxable_amount_base": "99.0",
      "tax_amount": "20.79",
      "tax_amount_base": "20.79"
    }
  ]
}

json

application/json

List all estimates

GET

https://moneybird.com/api/v2

/{administration_id}/estimates{format}

Returns a paginated list of all estimates in the administration.

The filter argument allows you to filter on the list of estimates. Filters are a combination of keys and values, separated by a comma: period:this_year,state:all. The available options for filtering are:

Filter	Type	Default	Description
state	`String`	`all`	`all`, `draft`, `open`, `late`, `accepted`, `rejected`, `billed` or `archived`
period	`String`	`this_year`	This can either be the description of a period (`this_month`, `prev_month`, `next_month`, `this_quarter`, `prev_quarter`, `next_quarter`, `this_year`, `prev_year`, `next_year`) or a custom period (`201301..201302`, `20130101..20130131`)
contact_id	`Integer`		Filters estimates by a single contact
workflow_id	`Integer`		Filters estimates by a single workflow

You can filter by multiple states at the same time as well. To do this, separate the state values by a pipe: state:draft|scheduled.

List all estimates › 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 all estimates › query Parameters

filter

string

See table above for detailed options.

page

integer | string

per_page

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

List all estimates › Responses

A list of estimates

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_person_id

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

A unique record identifier

estimate_id

string | null

estimate_sequence_id

string | null

workflow_id

string | integer · pattern: ^\d+$

A unique record identifier

document_style_id

string | integer · pattern: ^\d+$

A unique record identifier

identity_id

string | integer · pattern: ^\d+$

A unique record identifier

draft_id

integer | null

state

string · enum

Enum values:

draft

open

late

accepted

rejected

billed

archived

estimate_date

string | null · date

due_date

string · date

reference

string | null

language

string | null

currency

string

original_estimate_id

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

A unique record identifier

show_tax

boolean

Default: true

sign_online

boolean

Default: true

sent_at

string | null · date

accepted_at

string | null · date

rejected_at

string | null · date

archived_at

string | null · date

created_at

string | null · date-time

updated_at

string | null · date-time

public_view_code

string | null · pattern: ^\d+$

public_view_code_expires_at

string | null · date-time

version

integer

pre_text

string | null

post_text

string | null

object[]

prices_are_incl_tax

boolean

Default: false

url

string

object[]

GET/{administration_id}/estimates{format}

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

shell

Example Responses

[
  {
    "id": "471699997347284774",
    "administration_id": 123,
    "contact_id": "471699997034809107",
    "contact": {
      "id": "471699997034809107",
      "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:56:33.941Z",
      "updated_at": "2025-11-25T10:56:33.941Z",
      "version": 1764068193,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/4b3ce7dc535848b66408b0f8f7394989664d75fc21483edb18f77dd7e0add223/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "contact_person_id": null,
    "contact_person": null,
    "estimate_id": "2025-0004",
    "estimate_sequence_id": "0004",
    "workflow_id": "471699737245910162",
    "document_style_id": "471699737325601942",
    "identity_id": "471699736591598698",
    "draft_id": null,
    "state": "open",
    "estimate_date": "2025-11-25",
    "due_date": "2025-12-09",
    "reference": "Project X",
    "language": "nl",
    "currency": "EUR",
    "exchange_rate": "1.0",
    "discount": "0.0",
    "original_estimate_id": null,
    "show_tax": true,
    "sign_online": true,
    "sent_at": "2025-11-25",
    "accepted_at": null,
    "rejected_at": null,
    "archived_at": null,
    "created_at": "2025-11-25T10:56:34.239Z",
    "updated_at": "2025-11-25T10:56:34.290Z",
    "public_view_code": "615718",
    "public_view_code_expires_at": "2026-02-25T10:56:34.266Z",
    "version": 1764068194,
    "pre_text": "Hello, here is your quote",
    "post_text": "Please sign it",
    "details": [
      {
        "id": "471699997349381927",
        "administration_id": 123,
        "tax_rate_id": "471699736823334023",
        "ledger_account_id": "471699736746787959",
        "project_id": null,
        "product_id": null,
        "amount": "1 x",
        "amount_decimal": "1.0",
        "description": "Project X",
        "price": "300.0",
        "period": null,
        "row_order": 1,
        "total_price_excl_tax_with_discount": "300.0",
        "total_price_excl_tax_with_discount_base": "300.0",
        "tax_report_reference": [
          "NL/1a"
        ],
        "mandatory_tax_text": null,
        "created_at": "2025-11-25T10:56:34.242Z",
        "updated_at": "2025-11-25T10:56:34.288Z",
        "is_optional": false,
        "is_selected": true
      }
    ],
    "prices_are_incl_tax": false,
    "total_price_excl_tax": "300.0",
    "total_price_excl_tax_base": "300.0",
    "total_price_incl_tax": "363.0",
    "total_price_incl_tax_base": "363.0",
    "total_discount": "0.0",
    "url": "http://moneybird.dev/123/external/4b3ce7dc535848b66408b0f8f7394989664d75fc21483edb18f77dd7e0add223/73892c161face9ad33018c3dc3692808f8a5d7c0cfc04f499101ade48136578b/estimate",
    "custom_fields": [],
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "estimate_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-11-25T10:56:34.246Z",
        "updated_at": "2025-11-25T10:56:34.246Z"
      },
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "estimate_send_email",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {
          "email_address": "info@example.com",
          "email_message": "Geachte Foobar Holding B.V.,\n\nHierbij ontvangt u van ons een prijsopgave 2025-0004 voor onze\ndiensten.\n\nMet vriendelijke groet,\n\nParkietje B.V."
        },
        "created_at": "2025-11-25T10:56:34.297Z",
        "updated_at": "2025-11-25T10:56:34.297Z"
      }
    ],
    "tax_totals": [
      {
        "tax_rate_id": "471699736823334023",
        "taxable_amount": "300.0",
        "taxable_amount_base": "300.0",
        "tax_amount": "63.0",
        "tax_amount_base": "63.0"
      }
    ]
  },
  {
    "id": "471699997255010082",
    "administration_id": 123,
    "contact_id": "471699997034809107",
    "contact": {
      "id": "471699997034809107",
      "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:56:33.941Z",
      "updated_at": "2025-11-25T10:56:33.941Z",
      "version": 1764068193,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/4b3ce7dc535848b66408b0f8f7394989664d75fc21483edb18f77dd7e0add223/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "contact_person_id": null,
    "contact_person": null,
    "estimate_id": "2025-0003",
    "estimate_sequence_id": "0003",
    "workflow_id": "471699737245910162",
    "document_style_id": "471699737325601942",
    "identity_id": "471699736591598698",
    "draft_id": null,
    "state": "open",
    "estimate_date": "2025-11-25",
    "due_date": "2025-12-09",
    "reference": "Project X",
    "language": "nl",
    "currency": "EUR",
    "exchange_rate": "1.0",
    "discount": "0.0",
    "original_estimate_id": null,
    "show_tax": true,
    "sign_online": true,
    "sent_at": "2025-11-25",
    "accepted_at": null,
    "rejected_at": null,
    "archived_at": null,
    "created_at": "2025-11-25T10:56:34.151Z",
    "updated_at": "2025-11-25T10:56:34.202Z",
    "public_view_code": "558287",
    "public_view_code_expires_at": "2026-02-25T10:56:34.178Z",
    "version": 1764068194,
    "pre_text": "Hello, here is your quote",
    "post_text": "Please sign it",
    "details": [
      {
        "id": "471699997257107235",
        "administration_id": 123,
        "tax_rate_id": "471699736823334023",
        "ledger_account_id": "471699736746787959",
        "project_id": null,
        "product_id": null,
        "amount": "1 x",
        "amount_decimal": "1.0",
        "description": "Project X",
        "price": "300.0",
        "period": null,
        "row_order": 1,
        "total_price_excl_tax_with_discount": "300.0",
        "total_price_excl_tax_with_discount_base": "300.0",
        "tax_report_reference": [
          "NL/1a"
        ],
        "mandatory_tax_text": null,
        "created_at": "2025-11-25T10:56:34.153Z",
        "updated_at": "2025-11-25T10:56:34.200Z",
        "is_optional": false,
        "is_selected": true
      }
    ],
    "prices_are_incl_tax": false,
    "total_price_excl_tax": "300.0",
    "total_price_excl_tax_base": "300.0",
    "total_price_incl_tax": "363.0",
    "total_price_incl_tax_base": "363.0",
    "total_discount": "0.0",
    "url": "http://moneybird.dev/123/external/4b3ce7dc535848b66408b0f8f7394989664d75fc21483edb18f77dd7e0add223/716b462cfccb1a027a62124b4114c8ab2e23f2e929e42957a35f2c15c69092de/estimate",
    "custom_fields": [],
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "estimate_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-11-25T10:56:34.158Z",
        "updated_at": "2025-11-25T10:56:34.158Z"
      },
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "estimate_send_email",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {
          "email_address": "info@example.com",
          "email_message": "Geachte Foobar Holding B.V.,\n\nHierbij ontvangt u van ons een prijsopgave 2025-0003 voor onze\ndiensten.\n\nMet vriendelijke groet,\n\nParkietje B.V."
        },
        "created_at": "2025-11-25T10:56:34.209Z",
        "updated_at": "2025-11-25T10:56:34.209Z"
      }
    ],
    "tax_totals": [
      {
        "tax_rate_id": "471699736823334023",
        "taxable_amount": "300.0",
        "taxable_amount_base": "300.0",
        "tax_amount": "63.0",
        "tax_amount_base": "63.0"
      }
    ]
  },
  {
    "id": "471699997162735390",
    "administration_id": 123,
    "contact_id": "471699997034809107",
    "contact": {
      "id": "471699997034809107",
      "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:56:33.941Z",
      "updated_at": "2025-11-25T10:56:33.941Z",
      "version": 1764068193,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/4b3ce7dc535848b66408b0f8f7394989664d75fc21483edb18f77dd7e0add223/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "contact_person_id": null,
    "contact_person": null,
    "estimate_id": "2025-0002",
    "estimate_sequence_id": "0002",
    "workflow_id": "471699737245910162",
    "document_style_id": "471699737325601942",
    "identity_id": "471699736591598698",
    "draft_id": null,
    "state": "open",
    "estimate_date": "2025-11-25",
    "due_date": "2025-12-09",
    "reference": "Project X",
    "language": "nl",
    "currency": "EUR",
    "exchange_rate": "1.0",
    "discount": "0.0",
    "original_estimate_id": null,
    "show_tax": true,
    "sign_online": true,
    "sent_at": "2025-11-25",
    "accepted_at": null,
    "rejected_at": null,
    "archived_at": null,
    "created_at": "2025-11-25T10:56:34.063Z",
    "updated_at": "2025-11-25T10:56:34.113Z",
    "public_view_code": "339239",
    "public_view_code_expires_at": "2026-02-25T10:56:34.090Z",
    "version": 1764068194,
    "pre_text": "Hello, here is your quote",
    "post_text": "Please sign it",
    "details": [
      {
        "id": "471699997164832543",
        "administration_id": 123,
        "tax_rate_id": "471699736823334023",
        "ledger_account_id": "471699736746787959",
        "project_id": null,
        "product_id": null,
        "amount": "1 x",
        "amount_decimal": "1.0",
        "description": "Project X",
        "price": "300.0",
        "period": null,
        "row_order": 1,
        "total_price_excl_tax_with_discount": "300.0",
        "total_price_excl_tax_with_discount_base": "300.0",
        "tax_report_reference": [
          "NL/1a"
        ],
        "mandatory_tax_text": null,
        "created_at": "2025-11-25T10:56:34.066Z",
        "updated_at": "2025-11-25T10:56:34.112Z",
        "is_optional": false,
        "is_selected": true
      }
    ],
    "prices_are_incl_tax": false,
    "total_price_excl_tax": "300.0",
    "total_price_excl_tax_base": "300.0",
    "total_price_incl_tax": "363.0",
    "total_price_incl_tax_base": "363.0",
    "total_discount": "0.0",
    "url": "http://moneybird.dev/123/external/4b3ce7dc535848b66408b0f8f7394989664d75fc21483edb18f77dd7e0add223/c5b4d47153fba670b383c28396059bd6c6e1f3b062855bbf6a4af7f4e9455c71/estimate",
    "custom_fields": [],
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "estimate_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-11-25T10:56:34.070Z",
        "updated_at": "2025-11-25T10:56:34.070Z"
      },
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "estimate_send_email",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {
          "email_address": "info@example.com",
          "email_message": "Geachte Foobar Holding B.V.,\n\nHierbij ontvangt u van ons een prijsopgave 2025-0002 voor onze\ndiensten.\n\nMet vriendelijke groet,\n\nParkietje B.V."
        },
        "created_at": "2025-11-25T10:56:34.120Z",
        "updated_at": "2025-11-25T10:56:34.120Z"
      }
    ],
    "tax_totals": [
      {
        "tax_rate_id": "471699736823334023",
        "taxable_amount": "300.0",
        "taxable_amount_base": "300.0",
        "tax_amount": "63.0",
        "tax_amount_base": "63.0"
      }
    ]
  },
  {
    "id": "471699997073606425",
    "administration_id": 123,
    "contact_id": "471699997034809107",
    "contact": {
      "id": "471699997034809107",
      "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:56:33.941Z",
      "updated_at": "2025-11-25T10:56:33.941Z",
      "version": 1764068193,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/4b3ce7dc535848b66408b0f8f7394989664d75fc21483edb18f77dd7e0add223/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "contact_person_id": "471699997042149142",
    "contact_person": {
      "id": null,
      "contact_id": "471699997034809107",
      "administration_id": 123,
      "firstname": "Jan",
      "lastname": "Janssen",
      "phone": "123-456-2346",
      "email": "janjanssen@dev.null.moneybird.net",
      "department": "Sales",
      "created_at": "2025-11-25T10:56:33.949Z",
      "updated_at": "2025-11-25T10:56:33.949Z",
      "version": 1764068193
    },
    "estimate_id": "2025-0001",
    "estimate_sequence_id": "0001",
    "workflow_id": "471699737245910162",
    "document_style_id": "471699737325601942",
    "identity_id": "471699736591598698",
    "draft_id": null,
    "state": "open",
    "estimate_date": "2025-11-25",
    "due_date": "2025-12-09",
    "reference": "Project X",
    "language": "nl",
    "currency": "EUR",
    "exchange_rate": "1.0",
    "discount": "0.0",
    "original_estimate_id": null,
    "show_tax": true,
    "sign_online": true,
    "sent_at": "2025-11-25",
    "accepted_at": null,
    "rejected_at": null,
    "archived_at": null,
    "created_at": "2025-11-25T10:56:33.978Z",
    "updated_at": "2025-11-25T10:56:34.028Z",
    "public_view_code": "907761",
    "public_view_code_expires_at": "2026-02-25T10:56:34.004Z",
    "version": 1764068194,
    "pre_text": "Hello, here is your quote",
    "post_text": "Please sign it",
    "details": [
      {
        "id": "471699997075703578",
        "administration_id": 123,
        "tax_rate_id": "471699736823334023",
        "ledger_account_id": "471699736746787959",
        "project_id": null,
        "product_id": null,
        "amount": "1 x",
        "amount_decimal": "1.0",
        "description": "Project X",
        "price": "300.0",
        "period": null,
        "row_order": 1,
        "total_price_excl_tax_with_discount": "300.0",
        "total_price_excl_tax_with_discount_base": "300.0",
        "tax_report_reference": [
          "NL/1a"
        ],
        "mandatory_tax_text": null,
        "created_at": "2025-11-25T10:56:33.980Z",
        "updated_at": "2025-11-25T10:56:34.027Z",
        "is_optional": false,
        "is_selected": true
      }
    ],
    "prices_are_incl_tax": false,
    "total_price_excl_tax": "300.0",
    "total_price_excl_tax_base": "300.0",
    "total_price_incl_tax": "363.0",
    "total_price_incl_tax_base": "363.0",
    "total_discount": "0.0",
    "url": "http://moneybird.dev/123/external/4b3ce7dc535848b66408b0f8f7394989664d75fc21483edb18f77dd7e0add223/754f4ced6a5f02ce9a69aca79c571a15d617534ff7dffb286b65b7cb26652dbb/estimate",
    "custom_fields": [],
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "estimate_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-11-25T10:56:33.984Z",
        "updated_at": "2025-11-25T10:56:33.984Z"
      },
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "estimate_send_email",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {
          "email_address": "info@example.com; janjanssen@dev.null.moneybird.net",
          "email_message": "Geachte Jan Janssen,\n\nHierbij ontvangt u van ons een prijsopgave 2025-0001 voor onze\ndiensten.\n\nMet vriendelijke groet,\n\nParkietje B.V."
        },
        "created_at": "2025-11-25T10:56:34.035Z",
        "updated_at": "2025-11-25T10:56:34.035Z"
      }
    ],
    "tax_totals": [
      {
        "tax_rate_id": "471699736823334023",
        "taxable_amount": "300.0",
        "taxable_amount_base": "300.0",
        "tax_amount": "63.0",
        "tax_amount_base": "63.0"
      }
    ]
  }
]

json

application/json

Creates a new estimate

POST

https://moneybird.com/api/v2

/{administration_id}/estimates{format}

Creates a new estimate.

Creates a new estimate › 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

Creates a new estimate › Request Body

object

Creates a new estimate › Responses

Estimate created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_person_id

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

A unique record identifier

estimate_id

string | null

estimate_sequence_id

string | null

workflow_id

string | integer · pattern: ^\d+$

A unique record identifier

document_style_id

string | integer · pattern: ^\d+$

A unique record identifier

identity_id

string | integer · pattern: ^\d+$

A unique record identifier

draft_id

integer | null

state

string · enum

Enum values:

draft

open

late

accepted

rejected

billed

archived

estimate_date

string | null · date

due_date

string · date

reference

string | null

language

string | null

currency

string

original_estimate_id

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

A unique record identifier

show_tax

boolean

Default: true

sign_online

boolean

Default: true

sent_at

string | null · date

accepted_at

string | null · date

rejected_at

string | null · date

archived_at

string | null · date

created_at

string | null · date-time

updated_at

string | null · date-time

public_view_code

string | null · pattern: ^\d+$

public_view_code_expires_at

string | null · date-time

version

integer

pre_text

string | null

post_text

string | null

object[]

prices_are_incl_tax

boolean

Default: false

url

string

object[]

POST/{administration_id}/estimates{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/estimates:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "estimate": {
    "contact_id": 471699991277077800,
    "reference": "Estimate Reference"
  }
}
'

shell

Example Request Body

{
  "estimate": {
    "contact_id": 471699991277077800,
    "reference": "Estimate Reference"
  }
}

json

application/json

Example Responses

{
  "id": "471699991416538420",
  "administration_id": 123,
  "contact_id": "471699991277077801",
  "contact": {
    "id": "471699991277077801",
    "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:56:28.450Z",
    "updated_at": "2025-11-25T10:56:28.450Z",
    "version": 1764068188,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/3c28c75238e7686a9962277a54073ff2d440661458619bf8e41e2a608069100b/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [
      {
        "id": "471699991286514988",
        "contact_id": "471699991277077801",
        "administration_id": 123,
        "firstname": "Jan",
        "lastname": "Janssen",
        "phone": "123-456-2346",
        "email": "janjanssen@dev.null.moneybird.net",
        "department": "Sales",
        "created_at": "2025-11-25T10:56:28.459Z",
        "updated_at": "2025-11-25T10:56:28.459Z",
        "version": 1764068188
      }
    ],
    "archived": false
  },
  "contact_person_id": null,
  "contact_person": null,
  "estimate_id": null,
  "estimate_sequence_id": null,
  "workflow_id": "471699737245910162",
  "document_style_id": "471699737325601942",
  "identity_id": "471699736591598698",
  "draft_id": 2,
  "state": "draft",
  "estimate_date": null,
  "due_date": "2025-12-09",
  "reference": "Estimate Reference",
  "language": "nl",
  "currency": "EUR",
  "exchange_rate": "1.0",
  "discount": "0.0",
  "original_estimate_id": null,
  "show_tax": true,
  "sign_online": true,
  "sent_at": null,
  "accepted_at": null,
  "rejected_at": null,
  "archived_at": null,
  "created_at": "2025-11-25T10:56:28.583Z",
  "updated_at": "2025-11-25T10:56:28.583Z",
  "public_view_code": null,
  "public_view_code_expires_at": null,
  "version": 1764068188,
  "pre_text": "Geachte {recipient.name},\n\nHierbij ontvangt u van ons de prijsopgave {document.estimate_id} voor de onderstaande diensten.",
  "post_text": "We hopen u hiermee voldoende geïnformeerd te hebben.\n\nMet vriendelijke groet,\n\n{company.company_name}",
  "details": [],
  "prices_are_incl_tax": false,
  "total_price_excl_tax": "0.0",
  "total_price_excl_tax_base": "0.0",
  "total_price_incl_tax": "0.0",
  "total_price_incl_tax_base": "0.0",
  "total_discount": 0,
  "url": "http://moneybird.dev/123/external/3c28c75238e7686a9962277a54073ff2d440661458619bf8e41e2a608069100b/1768e822fcdd24bd6a449f93230ac085e87e43cb95b11790462dc0c9ab7ccfe9/estimate",
  "custom_fields": [],
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "estimate_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:56:28.588Z",
      "updated_at": "2025-11-25T10:56:28.588Z"
    }
  ],
  "tax_totals": []
}

json

application/json

Documents: Typeless documents External sales invoices