Estimates (or quotes) are proposals for products or services that you can send to your clients.
Get an estimate by estimate_id
Returns all information about an estimate with the given estimate id
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
estimate_idstring · requiredUnique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
An estimate
idstring | integer · pattern:^\d+$A unique record identifier
administration_idstring | integer · pattern:^\d+$A unique record identifier of an administration
contact_idstring | integer · pattern:^\d+$A unique record identifier
contactcontact_person_idstring | integer | null · pattern:^\d+$A unique record identifier
contact_personestimate_idstring | nullestimate_sequence_idstring | nullworkflow_idstring | integer · pattern:^\d+$A unique record identifier
document_style_idstring | integer · pattern:^\d+$A unique record identifier
identity_idstring | integer · pattern:^\d+$A unique record identifier
draft_idinteger | nullstatestring · enumEnum values:draftopenlateacceptedrejectedbilledarchivedestimate_datestring | null · datedue_datestring · datereferencestring | nulllanguagestring | nullcurrencystringexchange_ratediscountoriginal_estimate_idstring | integer | null · pattern:^\d+$A unique record identifier
show_taxbooleanDefault: truesign_onlinebooleanDefault: truesent_atstring | null · dateaccepted_atstring | null · daterejected_atstring | null · datearchived_atstring | null · datecreated_atstring | null · date-timeupdated_atstring | null · date-timepublic_view_codestring | null · pattern:^\d+$public_view_code_expires_atstring | null · date-timeversionintegerpre_textstring | nullpost_textstring | nulldetailsobject[]prices_are_incl_taxbooleanDefault: falsetotal_price_excl_taxtotal_price_excl_tax_basetotal_price_incl_taxtotal_price_incl_tax_basetotal_discounturlstringcustom_fieldsobject[]notesobject[]attachmentsobject[]eventsobject[]tax_totalsobject[]
List all ids and versions
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.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
query Parameters
filterstring
Responses
IDs and versions of records
idinteger | stringversioninteger | string
Fetch estimates with given ids
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.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
A list of estimates
idstring | integer · pattern:^\d+$A unique record identifier
administration_idstring | integer · pattern:^\d+$A unique record identifier of an administration
contact_idstring | integer · pattern:^\d+$A unique record identifier
contactcontact_person_idstring | integer | null · pattern:^\d+$A unique record identifier
contact_personestimate_idstring | nullestimate_sequence_idstring | nullworkflow_idstring | integer · pattern:^\d+$A unique record identifier
document_style_idstring | integer · pattern:^\d+$A unique record identifier
identity_idstring | integer · pattern:^\d+$A unique record identifier
draft_idinteger | nullstatestring · enumEnum values:draftopenlateacceptedrejectedbilledarchivedestimate_datestring | null · datedue_datestring · datereferencestring | nulllanguagestring | nullcurrencystringexchange_ratediscountoriginal_estimate_idstring | integer | null · pattern:^\d+$A unique record identifier
show_taxbooleanDefault: truesign_onlinebooleanDefault: truesent_atstring | null · dateaccepted_atstring | null · daterejected_atstring | null · datearchived_atstring | null · datecreated_atstring | null · date-timeupdated_atstring | null · date-timepublic_view_codestring | null · pattern:^\d+$public_view_code_expires_atstring | null · date-timeversionintegerpre_textstring | nullpost_textstring | nulldetailsobject[]prices_are_incl_taxbooleanDefault: falsetotal_price_excl_taxtotal_price_excl_tax_basetotal_price_incl_taxtotal_price_incl_tax_basetotal_discounturlstringcustom_fieldsobject[]notesobject[]attachmentsobject[]eventsobject[]tax_totalsobject[]
Download attachment
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.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
estimate_idstring | integer · pattern:^\d+$· requiredA unique record identifier
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Found
Delete an attachment
Deletes an attachment of an attachable.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
estimate_idstring | integer · pattern:^\d+$· requiredA unique record identifier
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Attachment deleted
Destroys note from entity
Deletes a note from the estimate.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
estimate_idstring | integer · pattern:^\d+$· requiredA unique record identifier
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Note deleted
Adds note to entity
Adds a note to the estimate.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
estimate_idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Note created
idstring | integer · pattern:^\d+$A unique record identifier
administration_idstring | integer · pattern:^\d+$A unique record identifier of an administration
entity_idstring | integer | null · pattern:^\d+$A unique record identifier
entity_typestringuser_idstring | integer · pattern:^\d+$A unique record identifier
assignee_idstring | integer | null · pattern:^\d+$A unique record identifier
todoboolean | string | nullDefault: falsenotestring | nullcompleted_atstring | null · date-timecompleted_by_idstring | integer | null · pattern:^\d+$A unique record identifier
todo_typestring | null · enumEnum values:sales_invoice_duepurchase_invoice_duegeneral_document_remindergeneral_document_duenew_document_awaiting_processingnew_financial_mutation_awaiting_processingfinancial_mutations_not_updatedsales_invoice_payment_not_linked_to_financial_mutationdataobject | nullcreated_atstring · date-timeupdated_atstring · date-time
Add attachment to estimate
Add an attachment to an estimate.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Status code
Bills an estimate
An invoice is created based on the accepted estimate.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Estimate billed
idstring | integer · pattern:^\d+$A unique record identifier
administration_idstring | integer · pattern:^\d+$A unique record identifier of an administration
contact_idstring | integer · pattern:^\d+$A unique record identifier
contactobjectcontact_person_idstring | integer | null · pattern:^\d+$A unique record identifier
contact_personinvoice_idstring | nullrecurring_sales_invoice_idstring | integer | null · pattern:^\d+$A unique record identifier
subscription_idstring | integer | null · pattern:^\d+$A unique record identifier
workflow_idstring | integer · pattern:^\d+$A unique record identifier
document_style_idstring | integer · pattern:^\d+$A unique record identifier
identity_idstring | integer · pattern:^\d+$A unique record identifier
draft_idinteger | nullstatestring · enumEnum values:draftscheduledopenpending_paymentremindedlatepaiduncollectibleinvoice_datestring | null · datedue_datestring · datepayment_conditionsstring | nullpayment_referencestring | nullshort_payment_referencestring | nullreferencestring | nulllanguagestring | nullcurrencystringdiscountstring | nulloriginal_sales_invoice_idstring | integer | null · pattern:^\d+$A unique record identifier
pausedbooleanpaid_atstring | null · datesent_atstring | null · datecreated_atstring · date-timeupdated_atstring · date-timepublic_view_codestring | nullpublic_view_code_expires_atstring | null · date-timeversionintegerdetailsobject[]paymentsobject[]total_paidstringtotal_unpaidstringtotal_unpaid_basestringprices_are_incl_taxbooleantotal_price_excl_taxstringtotal_price_excl_tax_basestringtotal_price_incl_taxstringtotal_price_incl_tax_basestringtotal_discountstringmarked_dubious_onstring | null · datemarked_uncollectible_onstring | null · datereminder_countinteger | nullnext_reminderstring | null · dateoriginal_estimate_idstring | integer | null · pattern:^\d+$A unique record identifier
urlstringpayment_urlstringcustom_fieldsobject[]notesobject[]attachmentsobject[]eventsobject[]tax_totalsobject[]time_entriesobject[]
Changes the state of an estimate
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.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Estimate updated
idstring | integer · pattern:^\d+$A unique record identifier
administration_idstring | integer · pattern:^\d+$A unique record identifier of an administration
contact_idstring | integer · pattern:^\d+$A unique record identifier
contactcontact_person_idstring | integer | null · pattern:^\d+$A unique record identifier
contact_personestimate_idstring | nullestimate_sequence_idstring | nullworkflow_idstring | integer · pattern:^\d+$A unique record identifier
document_style_idstring | integer · pattern:^\d+$A unique record identifier
identity_idstring | integer · pattern:^\d+$A unique record identifier
draft_idinteger | nullstatestring · enumEnum values:draftopenlateacceptedrejectedbilledarchivedestimate_datestring | null · datedue_datestring · datereferencestring | nulllanguagestring | nullcurrencystringexchange_ratediscountoriginal_estimate_idstring | integer | null · pattern:^\d+$A unique record identifier
show_taxbooleanDefault: truesign_onlinebooleanDefault: truesent_atstring | null · dateaccepted_atstring | null · daterejected_atstring | null · datearchived_atstring | null · datecreated_atstring | null · date-timeupdated_atstring | null · date-timepublic_view_codestring | null · pattern:^\d+$public_view_code_expires_atstring | null · date-timeversionintegerpre_textstring | nullpost_textstring | nulldetailsobject[]prices_are_incl_taxbooleanDefault: falsetotal_price_excl_taxtotal_price_excl_tax_basetotal_price_incl_taxtotal_price_incl_tax_basetotal_discounturlstringcustom_fieldsobject[]notesobject[]attachmentsobject[]eventsobject[]tax_totalsobject[]
Download estimate PDF by id
Redirects to the download URL of the estimate as PDF. The link is valid for 30 seconds.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
query Parameters
mediastringIn case you want to hide sender address and logo you can set this to 'stationery'.
Responses
Found
Sends an estimate
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.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Request Body
estimate_sendingobjectsenderboolean | stringsignature_outputstringaudit_trailstringip_addressstring
Responses
Estimate updated
idstring | integer · pattern:^\d+$A unique record identifier
administration_idstring | integer · pattern:^\d+$A unique record identifier of an administration
contact_idstring | integer · pattern:^\d+$A unique record identifier
contactcontact_person_idstring | integer | null · pattern:^\d+$A unique record identifier
contact_personestimate_idstring | nullestimate_sequence_idstring | nullworkflow_idstring | integer · pattern:^\d+$A unique record identifier
document_style_idstring | integer · pattern:^\d+$A unique record identifier
identity_idstring | integer · pattern:^\d+$A unique record identifier
draft_idinteger | nullstatestring · enumEnum values:draftopenlateacceptedrejectedbilledarchivedestimate_datestring | null · datedue_datestring · datereferencestring | nulllanguagestring | nullcurrencystringexchange_ratediscountoriginal_estimate_idstring | integer | null · pattern:^\d+$A unique record identifier
show_taxbooleanDefault: truesign_onlinebooleanDefault: truesent_atstring | null · dateaccepted_atstring | null · daterejected_atstring | null · datearchived_atstring | null · datecreated_atstring | null · date-timeupdated_atstring | null · date-timepublic_view_codestring | null · pattern:^\d+$public_view_code_expires_atstring | null · date-timeversionintegerpre_textstring | nullpost_textstring | nulldetailsobject[]prices_are_incl_taxbooleanDefault: falsetotal_price_excl_taxtotal_price_excl_tax_basetotal_price_incl_taxtotal_price_incl_tax_basetotal_discounturlstringcustom_fieldsobject[]notesobject[]attachmentsobject[]eventsobject[]tax_totalsobject[]
Get an estimate by id
Returns all information about an estimate.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
query Parameters
includesstring[]
Responses
A estimate
idstring | integer · pattern:^\d+$A unique record identifier
administration_idstring | integer · pattern:^\d+$A unique record identifier of an administration
contact_idstring | integer · pattern:^\d+$A unique record identifier
contactcontact_person_idstring | integer | null · pattern:^\d+$A unique record identifier
contact_personestimate_idstring | nullestimate_sequence_idstring | nullworkflow_idstring | integer · pattern:^\d+$A unique record identifier
document_style_idstring | integer · pattern:^\d+$A unique record identifier
identity_idstring | integer · pattern:^\d+$A unique record identifier
draft_idinteger | nullstatestring · enumEnum values:draftopenlateacceptedrejectedbilledarchivedestimate_datestring | null · datedue_datestring · datereferencestring | nulllanguagestring | nullcurrencystringexchange_ratediscountoriginal_estimate_idstring | integer | null · pattern:^\d+$A unique record identifier
show_taxbooleanDefault: truesign_onlinebooleanDefault: truesent_atstring | null · dateaccepted_atstring | null · daterejected_atstring | null · datearchived_atstring | null · datecreated_atstring | null · date-timeupdated_atstring | null · date-timepublic_view_codestring | null · pattern:^\d+$public_view_code_expires_atstring | null · date-timeversionintegerpre_textstring | nullpost_textstring | nulldetailsobject[]prices_are_incl_taxbooleanDefault: falsetotal_price_excl_taxtotal_price_excl_tax_basetotal_price_incl_taxtotal_price_incl_tax_basetotal_discounturlstringcustom_fieldsobject[]notesobject[]attachmentsobject[]eventsobject[]tax_totalsobject[]
Deletes an estimate
Deletes an estimate.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Estimate deleted
Updates an estimate
When updating an estimate, provide only the attributes you want to update. The other attributes will not be changed.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Estimate updated
idstring | integer · pattern:^\d+$A unique record identifier
administration_idstring | integer · pattern:^\d+$A unique record identifier of an administration
contact_idstring | integer · pattern:^\d+$A unique record identifier
contactcontact_person_idstring | integer | null · pattern:^\d+$A unique record identifier
contact_personestimate_idstring | nullestimate_sequence_idstring | nullworkflow_idstring | integer · pattern:^\d+$A unique record identifier
document_style_idstring | integer · pattern:^\d+$A unique record identifier
identity_idstring | integer · pattern:^\d+$A unique record identifier
draft_idinteger | nullstatestring · enumEnum values:draftopenlateacceptedrejectedbilledarchivedestimate_datestring | null · datedue_datestring · datereferencestring | nulllanguagestring | nullcurrencystringexchange_ratediscountoriginal_estimate_idstring | integer | null · pattern:^\d+$A unique record identifier
show_taxbooleanDefault: truesign_onlinebooleanDefault: truesent_atstring | null · dateaccepted_atstring | null · daterejected_atstring | null · datearchived_atstring | null · datecreated_atstring | null · date-timeupdated_atstring | null · date-timepublic_view_codestring | null · pattern:^\d+$public_view_code_expires_atstring | null · date-timeversionintegerpre_textstring | nullpost_textstring | nulldetailsobject[]prices_are_incl_taxbooleanDefault: falsetotal_price_excl_taxtotal_price_excl_tax_basetotal_price_incl_taxtotal_price_incl_tax_basetotal_discounturlstringcustom_fieldsobject[]notesobject[]attachmentsobject[]eventsobject[]tax_totalsobject[]
List all estimates
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.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
query Parameters
filterstringSee table above for detailed options.
pageinteger | stringper_pageinteger | string · min: 1 · max: 100 · pattern:^\d+$
Responses
A list of estimates
idstring | integer · pattern:^\d+$A unique record identifier
administration_idstring | integer · pattern:^\d+$A unique record identifier of an administration
contact_idstring | integer · pattern:^\d+$A unique record identifier
contactcontact_person_idstring | integer | null · pattern:^\d+$A unique record identifier
contact_personestimate_idstring | nullestimate_sequence_idstring | nullworkflow_idstring | integer · pattern:^\d+$A unique record identifier
document_style_idstring | integer · pattern:^\d+$A unique record identifier
identity_idstring | integer · pattern:^\d+$A unique record identifier
draft_idinteger | nullstatestring · enumEnum values:draftopenlateacceptedrejectedbilledarchivedestimate_datestring | null · datedue_datestring · datereferencestring | nulllanguagestring | nullcurrencystringexchange_ratediscountoriginal_estimate_idstring | integer | null · pattern:^\d+$A unique record identifier
show_taxbooleanDefault: truesign_onlinebooleanDefault: truesent_atstring | null · dateaccepted_atstring | null · daterejected_atstring | null · datearchived_atstring | null · datecreated_atstring | null · date-timeupdated_atstring | null · date-timepublic_view_codestring | null · pattern:^\d+$public_view_code_expires_atstring | null · date-timeversionintegerpre_textstring | nullpost_textstring | nulldetailsobject[]prices_are_incl_taxbooleanDefault: falsetotal_price_excl_taxtotal_price_excl_tax_basetotal_price_incl_taxtotal_price_incl_tax_basetotal_discounturlstringcustom_fieldsobject[]notesobject[]attachmentsobject[]eventsobject[]tax_totalsobject[]
Creates a new estimate
Creates a new estimate.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Estimate created
idstring | integer · pattern:^\d+$A unique record identifier
administration_idstring | integer · pattern:^\d+$A unique record identifier of an administration
contact_idstring | integer · pattern:^\d+$A unique record identifier
contactcontact_person_idstring | integer | null · pattern:^\d+$A unique record identifier
contact_personestimate_idstring | nullestimate_sequence_idstring | nullworkflow_idstring | integer · pattern:^\d+$A unique record identifier
document_style_idstring | integer · pattern:^\d+$A unique record identifier
identity_idstring | integer · pattern:^\d+$A unique record identifier
draft_idinteger | nullstatestring · enumEnum values:draftopenlateacceptedrejectedbilledarchivedestimate_datestring | null · datedue_datestring · datereferencestring | nulllanguagestring | nullcurrencystringexchange_ratediscountoriginal_estimate_idstring | integer | null · pattern:^\d+$A unique record identifier
show_taxbooleanDefault: truesign_onlinebooleanDefault: truesent_atstring | null · dateaccepted_atstring | null · daterejected_atstring | null · datearchived_atstring | null · datecreated_atstring | null · date-timeupdated_atstring | null · date-timepublic_view_codestring | null · pattern:^\d+$public_view_code_expires_atstring | null · date-timeversionintegerpre_textstring | nullpost_textstring | nulldetailsobject[]prices_are_incl_taxbooleanDefault: falsetotal_price_excl_taxtotal_price_excl_tax_basetotal_price_incl_taxtotal_price_incl_tax_basetotal_discounturlstringcustom_fieldsobject[]notesobject[]attachmentsobject[]eventsobject[]tax_totalsobject[]