Skip to content
Download OpenAPI description
Languages
Servers
https://api.kanbert.com/api/v1
Operations
Operations
Operations
Operations
Webhooks
Operations
Webhooks
Operations
Operations
Webhooks
Operations
Operations

Request

Required scopes: outgoing-invoice:read

Security
http or oauth2
Query
sortstring

Available sorts are invoice_number, title, date_of_invoice, sum_net, sum_tax, sum_external_costs, sum_gross, created_at, updated_at, computed_fields.<alias>.
You can sort by multiple options by separating them with a comma. To sort in descending order, use - sign in front of the sort, for example: -title.

Example: sort=sort=-created_at,title
includestring

Available includes are external_costs, line_items, discounts. You can include multiple options by separating them with a comma.

page[size]integer

The number of results that will be returned per page.

Default 30
page[cursor]string

The cursor to start the pagination from.

filterstring

Allowed filter fields (with allowed operators):

FieldTypeOperators
archivedenum: with, only, withouteq
titlestringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
statusenum<OutgoingInvoiceStatus>eq, ne, neq, in, nin, notin
payment_statusenum<OutgoingInvoicePaymentStatus>eq, ne, neq, in, nin, notin
invoice_numberstringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
is_creditbooleaneq, ne, neq, isnull, isnotnull, notnull
date_of_invoicedateeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, isnull, isnotnull, notnull
payment_due_datedateeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, isnull, isnotnull, notnull
sum_netcurrencyeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, contains, like, startswith, endswith, isnull, isnotnull, notnull
sum_taxcurrencyeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, contains, like, startswith, endswith, isnull, isnotnull, notnull
sum_grosscurrencyeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, contains, like, startswith, endswith, isnull, isnotnull, notnull
editor.idid<UserData>eq, ne, neq, in, nin, notin, isnull, isnotnull, notnull
editor.external_idstringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
editor.emailstringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
client.idid<ClientData>eq, ne, neq, in, nin, notin, isnull, isnotnull, notnull
client.namestringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
client.external_idstringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
client.shortcodestringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
project.idid<ProjectData>eq, ne, neq, in, nin, notin, isnull, isnotnull, notnull
project.titlestringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
project.external_idstringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
project.shortcodestringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
company.idid<CompanyData>eq, ne, neq, in, nin, notin, isnull, isnotnull, notnull
company.company_name:stringstringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
line_itemsRelation
- title (string)
- price (currency)
- amount (float)
- project.id (id)
- project.title (string)
- project.external_id (string)
- project.shortcode (string)
- total_net (currency)
- total_net_base (currency)
- total_net_without_discount (currency)
- total_gross (currency)
- total_gross_base (currency)
- total_gross_without_discount (currency)
- purchase_total (currency)
- purchase_total_base (currency)
- type (enum)
any, none, count, all
external_costsRelation
- title (string)
- amount (float)
- project.id (id)
- project.title (string)
- project.external_id (string)
- project.shortcode (string)
- supplier.id (id)
- supplier.name (string)
- price (currency)
- total (currency)
any, none, count, all

Filtering expression. Accepts either JSON (array/tree of conditions) or a readable string DSL.

You can check the full syntax at Docs Filtering section.

Special values:

  • me.id — current authenticated user id (usable on fields of type id). Example: id eq me.id
  • now — current date-time. Example: dueOn lt now
  • sow/eow — start/end of week. Examples: dueOn gt sow, dueOn lt eow
  • som/eom — start/end of month. Examples: dueOn gt som, dueOn lt eom
  • today — special date for today; with eq it expands to the whole day range. Example: dueOn eq today
  • today±Nd — relative day offset. Examples: today-30d, today+5d.
Example: filter=title contains "Acme" and (created_at >= "2024-01-01" or client.name contains "Corp")
computed_fields[alias]string

Dynamic computed relation fields (computed_fields[alias])

Declare ad-hoc aggregates per request using: computed_fields[<alias>] = relation.aggregate(args)

Syntax:

  • Count: relation.count() or relation.count(<where>)
  • Sum/Avg/Min/Max: relation.sum(<column>) or relation.sum(<column>, <where>)

Where is written using the same Filter DSL and is validated against the relation's allowed fields.

Use the prefix computed_fields. when referencing these aliases in filter or sort, e.g., filter=computed_fields.tasks_done gte 1 or sort=-computed_fields.tasks_done. Bare aliases are accepted for backward compatibility but deprecated.

Allowed relations for computed_fields (deny-all by default):

  • line_items (→ lineItems): aggregates: count, sum, avg, min, max; coalesce default: 0
  • external_costs (→ internalCosts): aggregates: count, sum, avg, min, max; coalesce default: 0

Example: ?computed_fields[tasks_done]=tasks.count(status%20eq%20%22Completed%22)&filter=computed_fields.tasks_done%20gt%200

Example: computed_fields[alias]=computed_fields[tasks_done]=tasks.count(status%20eq%20%22Completed%22)
curl -i -X GET \
  'https://api.kanbert.com/api/v1/outgoing-invoices?sort=sort%3D-created_at%2Ctitle&include=string&page%5Bsize%5D=30&page%5Bcursor%5D=string&filter=title+contains+%22Acme%22+and+%28created_at+%3E%3D+%222024-01-01%22+or+client.name+contains+%22Corp%22%29&computed_fields%5Balias%5D=computed_fields%5Btasks_done%5D%3Dtasks.count%28status%2520eq%2520%2522Completed%2522%29' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

The cursor paginated collection of OutgoingInvoiceData

Bodyapplication/json
dataArray of objects(OutgoingInvoiceData)required

The list of items

data[].​idstringrequired
data[].​external_idstring or nullrequired
data[].​external_originstring or nullrequired
data[].​master_invoice_idstring or null(OutgoingInvoiceMasterData)required

If invoice is part of a master invoice plan

data[].​invoice_numberstring or nullrequired
data[].​titlestringrequired
data[].​statusstring(OutgoingInvoiceStatus)required
estimate
Invoice is meant as estimate
open
Invoice in draft
bookable
Invoice is ready to be booked
booked
Invoice was booked
Enum"estimate""open""bookable""booked"
data[].​payment_statusstring(OutgoingInvoicePaymentStatus)required
Enum"open""partly_paid""paid""cancelled"
data[].​is_creditbooleanrequired
Default false
data[].​date_of_invoicestring(date-time)required
data[].​payment_due_datestring(date-time)required
data[].​payment_due_date_orgstring(date-time)required

Is the payment due date originally set

data[].​performance_range_startstring or null(date-time)required
data[].​performance_range_endstring or null(date-time)required
data[].​po_numberstring or nullrequired
data[].​referencestring or nullrequired
data[].​localestringrequired
data[].​currencystringrequired
data[].​addressstringrequired
data[].​address_changedbooleanrequired

If true the user manually overwrote the companies address

data[].​companyCompanyData (object) or nullrequired
Any of:
data[].​company.​idstringrequired
data[].​company.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​company.​external_originstring or nullrequired

If originated from external system origin is added

data[].​company.​vendor_identifierstring or nullrequired
data[].​company.​company_namestring or nullrequired
data[].​company.​localestring or nullrequired
data[].​company.​tax_uidstring or nullrequired
data[].​company.​taxation_enabledbooleanrequired

Can be used to indicate reverse charge ie

data[].​company.​ibanstring or nullrequired
data[].​company.​bicstring or nullrequired
data[].​company.​emailstring or nullrequired
data[].​company.​email_generalstring or nullrequired
data[].​company.​phonestring or nullrequired
data[].​company.​faxstring or nullrequired
data[].​company.​homepagestring or nullrequired
data[].​company.​invoices_by_postbooleanrequired
Default false
data[].​company.​invoices_by_emailbooleanrequired
Default false
data[].​company.​business_fieldBusinessFieldData (object) or nullrequired
Any of:
data[].​company.​business_field.​idstringrequired
data[].​company.​business_field.​namestringrequired
data[].​company.​company_sizeTagData (object) or nullrequired
Any of:
data[].​company.​company_size.​idstringrequired
data[].​company.​company_size.​titlestringrequired
data[].​company.​company_revenueTagData (object) or nullrequired
Any of:
data[].​company.​company_revenue.​idstringrequired
data[].​company.​company_revenue.​titlestringrequired
data[].​company.​person_attention_tostring or nullrequired
data[].​company.​address_invoice_titlestring or nullrequired
data[].​company.​address_invoice_streetstring or nullrequired
data[].​company.​address_invoice_housestring or nullrequired
data[].​company.​address_invoice_street2string or nullrequired
data[].​company.​address_invoice_zipstring or nullrequired
data[].​company.​address_invoice_statestring or nullrequired
data[].​company.​address_invoice_townstring or nullrequired
data[].​company.​address_invoice_countryCountryData (object) or nullrequired
Any of:
data[].​company.​address_invoice_country.​idstringrequired
data[].​company.​address_invoice_country.​namestringrequired
data[].​company.​address_invoice_country.​codestring(ISO 3166-1 alpha-2)required
data[].​company.​address_invoice_is_deliverybooleanrequired
data[].​company.​delivery_person_attention_tostring or nullrequired
data[].​company.​address_delivery_titlestring or nullrequired
data[].​company.​address_delivery_streetstring or nullrequired
data[].​company.​address_delivery_housestring or nullrequired
data[].​company.​address_delivery_street2string or nullrequired
data[].​company.​address_delivery_zipstring or nullrequired
data[].​company.​address_delivery_statestring or nullrequired
data[].​company.​address_delivery_townstring or nullrequired
data[].​company.​address_delivery_countryCountryData (object) or nullrequired
Any of:
data[].​company.​address_delivery_country.​idstringrequired
data[].​company.​address_delivery_country.​namestringrequired
data[].​company.​address_delivery_country.​codestring(ISO 3166-1 alpha-2)required
data[].​company.​clientClientData (object) or nullrequired
Any of:
data[].​company.​client.​idstringrequired
data[].​company.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​company.​client.​external_originstring or nullrequired

If originated from external system origin is added

data[].​company.​client.​namestringrequired
data[].​company.​client.​shortcodestring or nullrequired
data[].​company.​client.​primary_contactUserData (object) or nullrequired
Any of:
data[].​company.​client.​primary_contact.​idstringrequired
data[].​company.​client.​primary_contact.​first_namestringrequired
data[].​company.​client.​primary_contact.​last_namestringrequired
data[].​company.​client.​primary_contact.​emailstringrequired
data[].​company.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
data[].​company.​client.​primary_contact.​spaceobject(SpaceData)required
data[].​company.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

data[].​company.​client.​origin_space.​idstringrequired
data[].​company.​client.​origin_space.​namestringrequired
data[].​company.​tagsArray of objects(TagData)
data[].​company.​contactsArray of objects(ContactData)
data[].​company.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

data[].​company.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
data[].​company.​created_atstring(date-time)required
data[].​company.​updated_atstring or null(date-time)required
data[].​company.​deleted_atstring or null(date-time)required
data[].​company.​contact_companyobject(ContactCompanyPivotData)

Added included via relationship (contact -> companies or company -> contacts)

data[].​editorUserData (object) or nullrequired
Any of:
data[].​editor.​idstringrequired
data[].​editor.​first_namestringrequired
data[].​editor.​last_namestringrequired
data[].​editor.​emailstringrequired
data[].​editor.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
data[].​editor.​spaceobject(SpaceData)required
data[].​editor.​space.​idstringrequired
data[].​editor.​space.​namestringrequired
data[].​clientobject(ClientData)required
data[].​client.​idstringrequired
data[].​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​client.​external_originstring or nullrequired

If originated from external system origin is added

data[].​client.​namestringrequired
data[].​client.​shortcodestring or nullrequired
data[].​client.​primary_contactUserData (object) or nullrequired
Any of:
data[].​client.​primary_contact.​idstringrequired
data[].​client.​primary_contact.​first_namestringrequired
data[].​client.​primary_contact.​last_namestringrequired
data[].​client.​primary_contact.​emailstringrequired
data[].​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
data[].​client.​primary_contact.​spaceobject(SpaceData)required
data[].​client.​primary_contact.​space.​idstringrequired
data[].​client.​primary_contact.​space.​namestringrequired
data[].​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

data[].​client.​origin_space.​idstringrequired
data[].​client.​origin_space.​namestringrequired
data[].​projectProjectData (object) or nullrequired
Any of:
data[].​project.​idstringrequired
data[].​project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

data[].​project.​external_originstring or nullrequired

If originated from external system origin is added

data[].​project.​titlestringrequired
data[].​project.​shortcodestringrequired
data[].​project.​po_numberstring or nullrequired
data[].​project.​project_typeobject(ProjectTypeData)required
data[].​project.​project_type.​idstringrequired
data[].​project.​project_type.​titlestringrequired
data[].​project.​project_type.​shortcodestringrequired
data[].​project.​project_type.​colorstringrequired
data[].​project.​project_type.​orderintegerrequired
data[].​project.​project_type.​is_defaultbooleanrequired
data[].​project.​statusstringrequired
data[].​project.​is_acquisitionbooleanrequired
data[].​project.​is_privatebooleanrequired
data[].​project.​start_datestring or null(date)required
data[].​project.​end_datestring or null(date)required
data[].​project.​clientobject(ClientData)required
data[].​project.​client.​idstringrequired
data[].​project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​project.​client.​external_originstring or nullrequired

If originated from external system origin is added

data[].​project.​client.​namestringrequired
data[].​project.​client.​shortcodestring or nullrequired
data[].​project.​client.​primary_contactUserData (object) or nullrequired
Any of:
data[].​project.​client.​primary_contact.​idstringrequired
data[].​project.​client.​primary_contact.​first_namestringrequired
data[].​project.​client.​primary_contact.​last_namestringrequired
data[].​project.​client.​primary_contact.​emailstringrequired
data[].​project.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
data[].​project.​client.​primary_contact.​spaceobject(SpaceData)required
data[].​project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

data[].​project.​client.​origin_space.​idstringrequired
data[].​project.​client.​origin_space.​namestringrequired
data[].​project.​tagsArray of objects(ProjectTagData)
data[].​project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

data[].​project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
data[].​project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

data[].​project.​origin_space.​idstringrequired
data[].​project.​origin_space.​namestringrequired
data[].​project.​teamArray of objects(TeamMemberData)

Project team

data[].​project.​guestsArray of objects(TeamMemberData)

Project guests

data[].​project.​computed_fieldsobject
data[].​taxation_enabledbooleanrequired

Can be used to indicate reverse charge ie

data[].​sum_netnumberrequired
data[].​sum_taxnumberrequired
data[].​sum_grossnumberrequired
data[].​sum_external_costsnumberrequired
data[].​partial_indentstring or nullrequired

Indicator for partial invoices <currentInvoice>/<numberOfInvoices>

data[].​partial_factornumber or nullrequired

Factor in percentage for partial invoices

data[].​payment_discount_due_datestring or null(date-time)required
data[].​payment_discountnumber or nullrequired

Factor in percentage

data[].​discountsArray of objects(DiscountData)required
data[].​discounts[].​idstringrequired
data[].​discounts[].​titlestringrequired
data[].​discounts[].​discount_factornumber or nullrequired

Discount in percent

data[].​discounts[].​discount_absolutenumber or nullrequired

Is not calculated with invoices partial_factor in mind

data[].​discounts[].​from_parentbooleanrequired

If true, the discount was set in invoice master

data[].​discounts[].​is_payment_discountbooleanrequired

If true this discount was granted due to payment discount rules

data[].​discounts[].​orderintegerrequired

The order how discounts are applied

data[].​line_itemsArray of objects(OutgoingInvoiceLineItemData)required
data[].​line_items[].​idstringrequired
data[].​line_items[].​titlestringrequired
data[].​line_items[].​typestring(AccountingLineItemType)required
Enum"unit""category""page_break"
data[].​line_items[].​indentintegerrequired
data[].​line_items[].​orderintegerrequired
data[].​line_items[].​pricenumberrequired

Is always the full price of the unit (without partial_factor) See partial_factor if element is part of an partial invoice

data[].​line_items[].​amountnumberrequired
data[].​line_items[].​total_net_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

data[].​line_items[].​total_net_without_discountnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

data[].​line_items[].​total_netnumberrequired

Including unit discount (not invoice discounts) and partial_factor
See partial_factor if element is part of an partial invoice

data[].​line_items[].​total_gross_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

data[].​line_items[].​total_gross_without_discountnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

data[].​line_items[].​total_grossnumberrequired

Including unit discount (not invoice discounts) and partial_factor
See partial_factor if element is part of an partial invoice

data[].​line_items[].​tax_factornumberrequired
data[].​line_items[].​metricobject(MetricData)required
data[].​line_items[].​metric.​idstringrequired
data[].​line_items[].​metric.​titlestringrequired
data[].​line_items[].​metric.​title_pluralstringrequired
data[].​line_items[].​projectProjectData (object) or nullrequired
Any of:
data[].​line_items[].​project.​idstringrequired
data[].​line_items[].​project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

data[].​line_items[].​project.​external_originstring or nullrequired

If originated from external system origin is added

data[].​line_items[].​project.​titlestringrequired
data[].​line_items[].​project.​shortcodestringrequired
data[].​line_items[].​project.​po_numberstring or nullrequired
data[].​line_items[].​project.​project_typeobject(ProjectTypeData)required
data[].​line_items[].​project.​project_type.​idstringrequired
data[].​line_items[].​project.​project_type.​titlestringrequired
data[].​line_items[].​project.​project_type.​shortcodestringrequired
data[].​line_items[].​project.​project_type.​colorstringrequired
data[].​line_items[].​project.​project_type.​orderintegerrequired
data[].​line_items[].​project.​project_type.​is_defaultbooleanrequired
data[].​line_items[].​project.​statusstringrequired
data[].​line_items[].​project.​is_acquisitionbooleanrequired
data[].​line_items[].​project.​is_privatebooleanrequired
data[].​line_items[].​project.​start_datestring or null(date)required
data[].​line_items[].​project.​end_datestring or null(date)required
data[].​line_items[].​project.​clientobject(ClientData)required
data[].​line_items[].​project.​client.​idstringrequired
data[].​line_items[].​project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​line_items[].​project.​client.​external_originstring or nullrequired

If originated from external system origin is added

data[].​line_items[].​project.​client.​namestringrequired
data[].​line_items[].​project.​client.​shortcodestring or nullrequired
data[].​line_items[].​project.​client.​primary_contactUserData (object) or nullrequired
Any of:
data[].​line_items[].​project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

data[].​line_items[].​project.​tagsArray of objects(ProjectTagData)
data[].​line_items[].​project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

data[].​line_items[].​project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
data[].​line_items[].​project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

data[].​line_items[].​project.​origin_space.​idstringrequired
data[].​line_items[].​project.​origin_space.​namestringrequired
data[].​line_items[].​project.​teamArray of objects(TeamMemberData)

Project team

data[].​line_items[].​project.​guestsArray of objects(TeamMemberData)

Project guests

data[].​line_items[].​project.​computed_fieldsobject
data[].​line_items[].​partial_factorinteger or nullrequired

Value in percent. Describes the part of the unit that is included in the invoice

data[].​line_items[].​exclude_from_discountbooleanrequired

If true, the unit will be excluded from offer-wide discounts

Default false
data[].​line_items[].​discount_factornumber or nullrequired
data[].​line_items[].​discount_absolutenumber or nullrequired
data[].​line_items[].​discount_boundbooleanrequired

If true, the amount will multiply discount absolute

Default false
data[].​line_items[].​purchase_pricenumberrequired
Default 0
data[].​line_items[].​purchase_amountnumberrequired
Default 1
data[].​line_items[].​purchase_total_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

Default 0
data[].​line_items[].​purchase_totalnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

Default 0
data[].​line_items[].​purchase_price_boundbooleanrequired

If true, purchase_amount will be in sync with amount

Default false
data[].​line_items[].​descriptionstringrequired
data[].​line_items[].​payment_partial_typestring(OfferUnitIntervalType)required
Enum"once""monthly""yearly"
data[].​line_items[].​payment_partial_intervalinteger or nullrequired

Interval if payment partial type is monthly or `yearly

TypeIntervalDescription
onceanyOnce per offer
monthly1Every month in performance range
monthly3Every 3 months in performance range
monthly6Every 6 monthsin performance range
yearly1Every year in performance range
yearly3Every 3 years in performance range
yearly6Every 6 years in performance range
data[].​external_costsArray of objects(ExternalCostData)required

For partial invoices external costs will be empty - these are part of the invoice master plan

data[].​external_costs[].​idstringrequired
data[].​external_costs[].​titlestringrequired
data[].​external_costs[].​typestringrequired
data[].​external_costs[].​indentintegerrequired
data[].​external_costs[].​orderintegerrequired
data[].​external_costs[].​is_creditbooleanrequired

if true this cost is a credit

data[].​external_costs[].​is_optionalbooleanrequired
data[].​external_costs[].​pricenumberrequired
data[].​external_costs[].​amountnumberrequired
data[].​external_costs[].​totalnumberrequired
data[].​external_costs[].​supplierSupplierData (object) or nullrequired
Any of:
data[].​external_costs[].​supplier.​idstringrequired
data[].​external_costs[].​supplier.​namestringrequired
data[].​external_costs[].​clientClientData (object) or nullrequired
Any of:
data[].​external_costs[].​client.​idstringrequired
data[].​external_costs[].​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​external_costs[].​client.​external_originstring or nullrequired

If originated from external system origin is added

data[].​external_costs[].​client.​namestringrequired
data[].​external_costs[].​client.​shortcodestring or nullrequired
data[].​external_costs[].​client.​primary_contactUserData (object) or nullrequired
Any of:
data[].​external_costs[].​client.​primary_contact.​idstringrequired
data[].​external_costs[].​client.​primary_contact.​first_namestringrequired
data[].​external_costs[].​client.​primary_contact.​last_namestringrequired
data[].​external_costs[].​client.​primary_contact.​emailstringrequired
data[].​external_costs[].​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
data[].​external_costs[].​client.​primary_contact.​spaceobject(SpaceData)required
data[].​external_costs[].​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

data[].​external_costs[].​client.​origin_space.​idstringrequired
data[].​external_costs[].​client.​origin_space.​namestringrequired
data[].​external_costs[].​projectProjectData (object) or nullrequired
Any of:
data[].​external_costs[].​project.​idstringrequired
data[].​external_costs[].​project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

data[].​external_costs[].​project.​external_originstring or nullrequired

If originated from external system origin is added

data[].​external_costs[].​project.​titlestringrequired
data[].​external_costs[].​project.​shortcodestringrequired
data[].​external_costs[].​project.​po_numberstring or nullrequired
data[].​external_costs[].​project.​project_typeobject(ProjectTypeData)required
data[].​external_costs[].​project.​project_type.​idstringrequired
data[].​external_costs[].​project.​project_type.​titlestringrequired
data[].​external_costs[].​project.​project_type.​shortcodestringrequired
data[].​external_costs[].​project.​project_type.​colorstringrequired
data[].​external_costs[].​project.​project_type.​orderintegerrequired
data[].​external_costs[].​project.​project_type.​is_defaultbooleanrequired
data[].​external_costs[].​project.​statusstringrequired
data[].​external_costs[].​project.​is_acquisitionbooleanrequired
data[].​external_costs[].​project.​is_privatebooleanrequired
data[].​external_costs[].​project.​start_datestring or null(date)required
data[].​external_costs[].​project.​end_datestring or null(date)required
data[].​external_costs[].​project.​clientobject(ClientData)required
data[].​external_costs[].​project.​client.​idstringrequired
data[].​external_costs[].​project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​external_costs[].​project.​client.​external_originstring or nullrequired

If originated from external system origin is added

data[].​external_costs[].​project.​client.​namestringrequired
data[].​external_costs[].​project.​client.​shortcodestring or nullrequired
data[].​external_costs[].​project.​client.​primary_contactUserData (object) or nullrequired
Any of:
data[].​external_costs[].​project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

data[].​external_costs[].​project.​tagsArray of objects(ProjectTagData)
data[].​external_costs[].​project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

data[].​external_costs[].​project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
data[].​external_costs[].​project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

data[].​external_costs[].​project.​origin_space.​idstringrequired
data[].​external_costs[].​project.​origin_space.​namestringrequired
data[].​external_costs[].​project.​teamArray of objects(TeamMemberData)

Project team

data[].​external_costs[].​project.​guestsArray of objects(TeamMemberData)

Project guests

data[].​external_costs[].​project.​computed_fieldsobject
data[].​external_costs[].​statusstring or nullrequired
data[].​external_costs[].​payment_partial_typestring(OfferUnitIntervalType)required
Enum"once""monthly""yearly"
data[].​external_costs[].​payment_partial_intervalinteger or nullrequired

Interval if payment partial type is monthly or `yearly

TypeIntervalDescription
onceanyOnce per offer
monthly1Every month in performance range
monthly3Every 3 months in performance range
monthly6Every 6 monthsin performance range
yearly1Every year in performance range
yearly3Every 3 years in performance range
yearly6Every 6 years in performance range
data[].​external_costs[].​created_atstring(date-time)required
data[].​external_costs[].​updated_atstring or null(date-time)required
data[].​created_atstring(date-time)required
data[].​updated_atstring or null(date-time)required
data[].​deleted_atstring or null(date-time)required
data[].​computed_fieldsobject
linksArray of stringsrequired
metaobjectrequired
meta.​pathstring or nullrequired

Base path for paginator generated URLs.

meta.​per_pageintegerrequired

Number of items shown per page.

meta.​next_cursorstring or nullrequired
meta.​next_cursor_urlstring or nullrequired
meta.​prev_cursorstring or nullrequired
meta.​prev_cursor_urlstring or nullrequired
Response
application/json
{ "data": [ { … } ], "links": [ "string" ], "meta": { "path": "string", "per_page": 0, "next_cursor": "string", "next_cursor_url": "string", "prev_cursor": "string", "prev_cursor_url": "string" } }

Request

Required scopes: outgoing-invoice:read

Security
http or oauth2
Query
sortstring

Available sorts are title, performance_range_start, performance_range_end, sum_net, sum_tax, sum_external_costs, sum_gross, created_at, updated_at, computed_fields.<alias>.
You can sort by multiple options by separating them with a comma. To sort in descending order, use - sign in front of the sort, for example: -title.

Example: sort=sort=-created_at,title
includestring

Available includes are external_costs, line_items, discounts. You can include multiple options by separating them with a comma.

page[size]integer

The number of results that will be returned per page.

Default 30
page[cursor]string

The cursor to start the pagination from.

filterstring

Allowed filter fields (with allowed operators):

FieldTypeOperators
archivedenum: with, only, withouteq
titlestringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
sum_netcurrencyeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, contains, like, startswith, endswith, isnull, isnotnull, notnull
sum_taxcurrencyeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, contains, like, startswith, endswith, isnull, isnotnull, notnull
sum_grosscurrencyeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, contains, like, startswith, endswith, isnull, isnotnull, notnull
editor.idid<UserData>eq, ne, neq, in, nin, notin, isnull, isnotnull, notnull
editor.external_idstringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
editor.emailstringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
client.idid<ClientData>eq, ne, neq, in, nin, notin, isnull, isnotnull, notnull
client.namestringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
client.external_idstringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
client.shortcodestringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
project.idid<ProjectData>eq, ne, neq, in, nin, notin, isnull, isnotnull, notnull
project.titlestringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
project.external_idstringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
project.shortcodestringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
company.idid<CompanyData>eq, ne, neq, in, nin, notin, isnull, isnotnull, notnull
company.company_name:stringstringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
line_itemsRelation
- title (string)
- price (currency)
- amount (float)
- project.id (id)
- project.title (string)
- project.external_id (string)
- project.shortcode (string)
- total_net (currency)
- total_net_base (currency)
- total_net_without_discount (currency)
- total_gross (currency)
- total_gross_base (currency)
- total_gross_without_discount (currency)
- purchase_total (currency)
- purchase_total_base (currency)
- type (enum)
any, none, count, all
external_costsRelation
- title (string)
- amount (float)
- project.id (id)
- project.title (string)
- project.external_id (string)
- project.shortcode (string)
- supplier.id (id)
- supplier.name (string)
- price (currency)
- total (currency)
any, none, count, all

Filtering expression. Accepts either JSON (array/tree of conditions) or a readable string DSL.

You can check the full syntax at Docs Filtering section.

Special values:

  • me.id — current authenticated user id (usable on fields of type id). Example: id eq me.id
  • now — current date-time. Example: dueOn lt now
  • sow/eow — start/end of week. Examples: dueOn gt sow, dueOn lt eow
  • som/eom — start/end of month. Examples: dueOn gt som, dueOn lt eom
  • today — special date for today; with eq it expands to the whole day range. Example: dueOn eq today
  • today±Nd — relative day offset. Examples: today-30d, today+5d.
Example: filter=title contains "Acme" and (created_at >= "2024-01-01" or client.name contains "Corp")
computed_fields[alias]string

Dynamic computed relation fields (computed_fields[alias])

Declare ad-hoc aggregates per request using: computed_fields[<alias>] = relation.aggregate(args)

Syntax:

  • Count: relation.count() or relation.count(<where>)
  • Sum/Avg/Min/Max: relation.sum(<column>) or relation.sum(<column>, <where>)

Where is written using the same Filter DSL and is validated against the relation's allowed fields.

Use the prefix computed_fields. when referencing these aliases in filter or sort, e.g., filter=computed_fields.tasks_done gte 1 or sort=-computed_fields.tasks_done. Bare aliases are accepted for backward compatibility but deprecated.

Allowed relations for computed_fields (deny-all by default):

  • line_items (→ lineItems): aggregates: count, sum, avg, min, max; coalesce default: 0
  • external_costs (→ internalCosts): aggregates: count, sum, avg, min, max; coalesce default: 0

Example: ?computed_fields[tasks_done]=tasks.count(status%20eq%20%22Completed%22)&filter=computed_fields.tasks_done%20gt%200

Example: computed_fields[alias]=computed_fields[tasks_done]=tasks.count(status%20eq%20%22Completed%22)
curl -i -X GET \
  'https://api.kanbert.com/api/v1/outgoing-invoices/master?sort=sort%3D-created_at%2Ctitle&include=string&page%5Bsize%5D=30&page%5Bcursor%5D=string&filter=title+contains+%22Acme%22+and+%28created_at+%3E%3D+%222024-01-01%22+or+client.name+contains+%22Corp%22%29&computed_fields%5Balias%5D=computed_fields%5Btasks_done%5D%3Dtasks.count%28status%2520eq%2520%2522Completed%2522%29' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

The cursor paginated collection of OutgoingInvoiceMasterData

Bodyapplication/json
dataArray of objects(OutgoingInvoiceMasterData)required

The list of items

data[].​idstringrequired
data[].​titlestringrequired
data[].​typestring(OutgoingInvoiceMasterType)required
once
If type is once, then the master is a partial plan
recurring1
Recurring every month
recurring3
Recurring every 3 months
recurring6
Recurring every 6 months
recurring12
Recurring every 12 months
Enum"once""recurring1""recurring3""recurring6""recurring12"
data[].​performance_range_startstring or null(date-time)required
data[].​performance_range_endstring or null(date-time)required
data[].​localestringrequired
data[].​currencystringrequired
data[].​addressstringrequired
data[].​address_changedbooleanrequired

If true the user manually overwrote the companies address

data[].​companyCompanyData (object) or nullrequired
Any of:
data[].​company.​idstringrequired
data[].​company.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​company.​external_originstring or nullrequired

If originated from external system origin is added

data[].​company.​vendor_identifierstring or nullrequired
data[].​company.​company_namestring or nullrequired
data[].​company.​localestring or nullrequired
data[].​company.​tax_uidstring or nullrequired
data[].​company.​taxation_enabledbooleanrequired

Can be used to indicate reverse charge ie

data[].​company.​ibanstring or nullrequired
data[].​company.​bicstring or nullrequired
data[].​company.​emailstring or nullrequired
data[].​company.​email_generalstring or nullrequired
data[].​company.​phonestring or nullrequired
data[].​company.​faxstring or nullrequired
data[].​company.​homepagestring or nullrequired
data[].​company.​invoices_by_postbooleanrequired
Default false
data[].​company.​invoices_by_emailbooleanrequired
Default false
data[].​company.​business_fieldBusinessFieldData (object) or nullrequired
Any of:
data[].​company.​business_field.​idstringrequired
data[].​company.​business_field.​namestringrequired
data[].​company.​company_sizeTagData (object) or nullrequired
Any of:
data[].​company.​company_size.​idstringrequired
data[].​company.​company_size.​titlestringrequired
data[].​company.​company_revenueTagData (object) or nullrequired
Any of:
data[].​company.​company_revenue.​idstringrequired
data[].​company.​company_revenue.​titlestringrequired
data[].​company.​person_attention_tostring or nullrequired
data[].​company.​address_invoice_titlestring or nullrequired
data[].​company.​address_invoice_streetstring or nullrequired
data[].​company.​address_invoice_housestring or nullrequired
data[].​company.​address_invoice_street2string or nullrequired
data[].​company.​address_invoice_zipstring or nullrequired
data[].​company.​address_invoice_statestring or nullrequired
data[].​company.​address_invoice_townstring or nullrequired
data[].​company.​address_invoice_countryCountryData (object) or nullrequired
Any of:
data[].​company.​address_invoice_country.​idstringrequired
data[].​company.​address_invoice_country.​namestringrequired
data[].​company.​address_invoice_country.​codestring(ISO 3166-1 alpha-2)required
data[].​company.​address_invoice_is_deliverybooleanrequired
data[].​company.​delivery_person_attention_tostring or nullrequired
data[].​company.​address_delivery_titlestring or nullrequired
data[].​company.​address_delivery_streetstring or nullrequired
data[].​company.​address_delivery_housestring or nullrequired
data[].​company.​address_delivery_street2string or nullrequired
data[].​company.​address_delivery_zipstring or nullrequired
data[].​company.​address_delivery_statestring or nullrequired
data[].​company.​address_delivery_townstring or nullrequired
data[].​company.​address_delivery_countryCountryData (object) or nullrequired
Any of:
data[].​company.​address_delivery_country.​idstringrequired
data[].​company.​address_delivery_country.​namestringrequired
data[].​company.​address_delivery_country.​codestring(ISO 3166-1 alpha-2)required
data[].​company.​clientClientData (object) or nullrequired
Any of:
data[].​company.​client.​idstringrequired
data[].​company.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​company.​client.​external_originstring or nullrequired

If originated from external system origin is added

data[].​company.​client.​namestringrequired
data[].​company.​client.​shortcodestring or nullrequired
data[].​company.​client.​primary_contactUserData (object) or nullrequired
Any of:
data[].​company.​client.​primary_contact.​idstringrequired
data[].​company.​client.​primary_contact.​first_namestringrequired
data[].​company.​client.​primary_contact.​last_namestringrequired
data[].​company.​client.​primary_contact.​emailstringrequired
data[].​company.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
data[].​company.​client.​primary_contact.​spaceobject(SpaceData)required
data[].​company.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

data[].​company.​client.​origin_space.​idstringrequired
data[].​company.​client.​origin_space.​namestringrequired
data[].​company.​tagsArray of objects(TagData)
data[].​company.​contactsArray of objects(ContactData)
data[].​company.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

data[].​company.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
data[].​company.​created_atstring(date-time)required
data[].​company.​updated_atstring or null(date-time)required
data[].​company.​deleted_atstring or null(date-time)required
data[].​company.​contact_companyobject(ContactCompanyPivotData)

Added included via relationship (contact -> companies or company -> contacts)

data[].​editorUserData (object) or nullrequired
Any of:
data[].​editor.​idstringrequired
data[].​editor.​first_namestringrequired
data[].​editor.​last_namestringrequired
data[].​editor.​emailstringrequired
data[].​editor.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
data[].​editor.​spaceobject(SpaceData)required
data[].​editor.​space.​idstringrequired
data[].​editor.​space.​namestringrequired
data[].​clientClientData (object) or nullrequired
Any of:
data[].​client.​idstringrequired
data[].​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​client.​external_originstring or nullrequired

If originated from external system origin is added

data[].​client.​namestringrequired
data[].​client.​shortcodestring or nullrequired
data[].​client.​primary_contactUserData (object) or nullrequired
Any of:
data[].​client.​primary_contact.​idstringrequired
data[].​client.​primary_contact.​first_namestringrequired
data[].​client.​primary_contact.​last_namestringrequired
data[].​client.​primary_contact.​emailstringrequired
data[].​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
data[].​client.​primary_contact.​spaceobject(SpaceData)required
data[].​client.​primary_contact.​space.​idstringrequired
data[].​client.​primary_contact.​space.​namestringrequired
data[].​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

data[].​client.​origin_space.​idstringrequired
data[].​client.​origin_space.​namestringrequired
data[].​projectProjectData (object) or nullrequired
Any of:
data[].​project.​idstringrequired
data[].​project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

data[].​project.​external_originstring or nullrequired

If originated from external system origin is added

data[].​project.​titlestringrequired
data[].​project.​shortcodestringrequired
data[].​project.​po_numberstring or nullrequired
data[].​project.​project_typeobject(ProjectTypeData)required
data[].​project.​project_type.​idstringrequired
data[].​project.​project_type.​titlestringrequired
data[].​project.​project_type.​shortcodestringrequired
data[].​project.​project_type.​colorstringrequired
data[].​project.​project_type.​orderintegerrequired
data[].​project.​project_type.​is_defaultbooleanrequired
data[].​project.​statusstringrequired
data[].​project.​is_acquisitionbooleanrequired
data[].​project.​is_privatebooleanrequired
data[].​project.​start_datestring or null(date)required
data[].​project.​end_datestring or null(date)required
data[].​project.​clientobject(ClientData)required
data[].​project.​client.​idstringrequired
data[].​project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​project.​client.​external_originstring or nullrequired

If originated from external system origin is added

data[].​project.​client.​namestringrequired
data[].​project.​client.​shortcodestring or nullrequired
data[].​project.​client.​primary_contactUserData (object) or nullrequired
Any of:
data[].​project.​client.​primary_contact.​idstringrequired
data[].​project.​client.​primary_contact.​first_namestringrequired
data[].​project.​client.​primary_contact.​last_namestringrequired
data[].​project.​client.​primary_contact.​emailstringrequired
data[].​project.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
data[].​project.​client.​primary_contact.​spaceobject(SpaceData)required
data[].​project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

data[].​project.​client.​origin_space.​idstringrequired
data[].​project.​client.​origin_space.​namestringrequired
data[].​project.​tagsArray of objects(ProjectTagData)
data[].​project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

data[].​project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
data[].​project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

data[].​project.​origin_space.​idstringrequired
data[].​project.​origin_space.​namestringrequired
data[].​project.​teamArray of objects(TeamMemberData)

Project team

data[].​project.​guestsArray of objects(TeamMemberData)

Project guests

data[].​project.​computed_fieldsobject
data[].​taxation_enabledbooleanrequired

Can be used to indicate reverse charge ie

data[].​sum_netnumberrequired
data[].​sum_taxnumberrequired
data[].​sum_grossnumberrequired
data[].​sum_external_costsnumberrequired
data[].​payment_discountnumber or nullrequired

Factor in percentage

data[].​discountsArray of objects(DiscountData)required
data[].​discounts[].​idstringrequired
data[].​discounts[].​titlestringrequired
data[].​discounts[].​discount_factornumber or nullrequired

Discount in percent

data[].​discounts[].​discount_absolutenumber or nullrequired

Is not calculated with invoices partial_factor in mind

data[].​discounts[].​from_parentbooleanrequired

If true, the discount was set in invoice master

data[].​discounts[].​is_payment_discountbooleanrequired

If true this discount was granted due to payment discount rules

data[].​discounts[].​orderintegerrequired

The order how discounts are applied

data[].​line_itemsArray of objects(OutgoingInvoiceLineItemData)required
data[].​line_items[].​idstringrequired
data[].​line_items[].​titlestringrequired
data[].​line_items[].​typestring(AccountingLineItemType)required
Enum"unit""category""page_break"
data[].​line_items[].​indentintegerrequired
data[].​line_items[].​orderintegerrequired
data[].​line_items[].​pricenumberrequired

Is always the full price of the unit (without partial_factor) See partial_factor if element is part of an partial invoice

data[].​line_items[].​amountnumberrequired
data[].​line_items[].​total_net_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

data[].​line_items[].​total_net_without_discountnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

data[].​line_items[].​total_netnumberrequired

Including unit discount (not invoice discounts) and partial_factor
See partial_factor if element is part of an partial invoice

data[].​line_items[].​total_gross_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

data[].​line_items[].​total_gross_without_discountnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

data[].​line_items[].​total_grossnumberrequired

Including unit discount (not invoice discounts) and partial_factor
See partial_factor if element is part of an partial invoice

data[].​line_items[].​tax_factornumberrequired
data[].​line_items[].​metricobject(MetricData)required
data[].​line_items[].​metric.​idstringrequired
data[].​line_items[].​metric.​titlestringrequired
data[].​line_items[].​metric.​title_pluralstringrequired
data[].​line_items[].​projectProjectData (object) or nullrequired
Any of:
data[].​line_items[].​project.​idstringrequired
data[].​line_items[].​project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

data[].​line_items[].​project.​external_originstring or nullrequired

If originated from external system origin is added

data[].​line_items[].​project.​titlestringrequired
data[].​line_items[].​project.​shortcodestringrequired
data[].​line_items[].​project.​po_numberstring or nullrequired
data[].​line_items[].​project.​project_typeobject(ProjectTypeData)required
data[].​line_items[].​project.​project_type.​idstringrequired
data[].​line_items[].​project.​project_type.​titlestringrequired
data[].​line_items[].​project.​project_type.​shortcodestringrequired
data[].​line_items[].​project.​project_type.​colorstringrequired
data[].​line_items[].​project.​project_type.​orderintegerrequired
data[].​line_items[].​project.​project_type.​is_defaultbooleanrequired
data[].​line_items[].​project.​statusstringrequired
data[].​line_items[].​project.​is_acquisitionbooleanrequired
data[].​line_items[].​project.​is_privatebooleanrequired
data[].​line_items[].​project.​start_datestring or null(date)required
data[].​line_items[].​project.​end_datestring or null(date)required
data[].​line_items[].​project.​clientobject(ClientData)required
data[].​line_items[].​project.​client.​idstringrequired
data[].​line_items[].​project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​line_items[].​project.​client.​external_originstring or nullrequired

If originated from external system origin is added

data[].​line_items[].​project.​client.​namestringrequired
data[].​line_items[].​project.​client.​shortcodestring or nullrequired
data[].​line_items[].​project.​client.​primary_contactUserData (object) or nullrequired
Any of:
data[].​line_items[].​project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

data[].​line_items[].​project.​tagsArray of objects(ProjectTagData)
data[].​line_items[].​project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

data[].​line_items[].​project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
data[].​line_items[].​project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

data[].​line_items[].​project.​origin_space.​idstringrequired
data[].​line_items[].​project.​origin_space.​namestringrequired
data[].​line_items[].​project.​teamArray of objects(TeamMemberData)

Project team

data[].​line_items[].​project.​guestsArray of objects(TeamMemberData)

Project guests

data[].​line_items[].​project.​computed_fieldsobject
data[].​line_items[].​partial_factorinteger or nullrequired

Value in percent. Describes the part of the unit that is included in the invoice

data[].​line_items[].​exclude_from_discountbooleanrequired

If true, the unit will be excluded from offer-wide discounts

Default false
data[].​line_items[].​discount_factornumber or nullrequired
data[].​line_items[].​discount_absolutenumber or nullrequired
data[].​line_items[].​discount_boundbooleanrequired

If true, the amount will multiply discount absolute

Default false
data[].​line_items[].​purchase_pricenumberrequired
Default 0
data[].​line_items[].​purchase_amountnumberrequired
Default 1
data[].​line_items[].​purchase_total_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

Default 0
data[].​line_items[].​purchase_totalnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

Default 0
data[].​line_items[].​purchase_price_boundbooleanrequired

If true, purchase_amount will be in sync with amount

Default false
data[].​line_items[].​descriptionstringrequired
data[].​line_items[].​payment_partial_typestring(OfferUnitIntervalType)required
Enum"once""monthly""yearly"
data[].​line_items[].​payment_partial_intervalinteger or nullrequired

Interval if payment partial type is monthly or `yearly

TypeIntervalDescription
onceanyOnce per offer
monthly1Every month in performance range
monthly3Every 3 months in performance range
monthly6Every 6 monthsin performance range
yearly1Every year in performance range
yearly3Every 3 years in performance range
yearly6Every 6 years in performance range
data[].​external_costsArray of objects(ExternalCostData)required

For partial invoices external costs will be empty - these are part of the invoice master plan

data[].​external_costs[].​idstringrequired
data[].​external_costs[].​titlestringrequired
data[].​external_costs[].​typestringrequired
data[].​external_costs[].​indentintegerrequired
data[].​external_costs[].​orderintegerrequired
data[].​external_costs[].​is_creditbooleanrequired

if true this cost is a credit

data[].​external_costs[].​is_optionalbooleanrequired
data[].​external_costs[].​pricenumberrequired
data[].​external_costs[].​amountnumberrequired
data[].​external_costs[].​totalnumberrequired
data[].​external_costs[].​supplierSupplierData (object) or nullrequired
Any of:
data[].​external_costs[].​supplier.​idstringrequired
data[].​external_costs[].​supplier.​namestringrequired
data[].​external_costs[].​clientClientData (object) or nullrequired
Any of:
data[].​external_costs[].​client.​idstringrequired
data[].​external_costs[].​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​external_costs[].​client.​external_originstring or nullrequired

If originated from external system origin is added

data[].​external_costs[].​client.​namestringrequired
data[].​external_costs[].​client.​shortcodestring or nullrequired
data[].​external_costs[].​client.​primary_contactUserData (object) or nullrequired
Any of:
data[].​external_costs[].​client.​primary_contact.​idstringrequired
data[].​external_costs[].​client.​primary_contact.​first_namestringrequired
data[].​external_costs[].​client.​primary_contact.​last_namestringrequired
data[].​external_costs[].​client.​primary_contact.​emailstringrequired
data[].​external_costs[].​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
data[].​external_costs[].​client.​primary_contact.​spaceobject(SpaceData)required
data[].​external_costs[].​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

data[].​external_costs[].​client.​origin_space.​idstringrequired
data[].​external_costs[].​client.​origin_space.​namestringrequired
data[].​external_costs[].​projectProjectData (object) or nullrequired
Any of:
data[].​external_costs[].​project.​idstringrequired
data[].​external_costs[].​project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

data[].​external_costs[].​project.​external_originstring or nullrequired

If originated from external system origin is added

data[].​external_costs[].​project.​titlestringrequired
data[].​external_costs[].​project.​shortcodestringrequired
data[].​external_costs[].​project.​po_numberstring or nullrequired
data[].​external_costs[].​project.​project_typeobject(ProjectTypeData)required
data[].​external_costs[].​project.​project_type.​idstringrequired
data[].​external_costs[].​project.​project_type.​titlestringrequired
data[].​external_costs[].​project.​project_type.​shortcodestringrequired
data[].​external_costs[].​project.​project_type.​colorstringrequired
data[].​external_costs[].​project.​project_type.​orderintegerrequired
data[].​external_costs[].​project.​project_type.​is_defaultbooleanrequired
data[].​external_costs[].​project.​statusstringrequired
data[].​external_costs[].​project.​is_acquisitionbooleanrequired
data[].​external_costs[].​project.​is_privatebooleanrequired
data[].​external_costs[].​project.​start_datestring or null(date)required
data[].​external_costs[].​project.​end_datestring or null(date)required
data[].​external_costs[].​project.​clientobject(ClientData)required
data[].​external_costs[].​project.​client.​idstringrequired
data[].​external_costs[].​project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​external_costs[].​project.​client.​external_originstring or nullrequired

If originated from external system origin is added

data[].​external_costs[].​project.​client.​namestringrequired
data[].​external_costs[].​project.​client.​shortcodestring or nullrequired
data[].​external_costs[].​project.​client.​primary_contactUserData (object) or nullrequired
Any of:
data[].​external_costs[].​project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

data[].​external_costs[].​project.​tagsArray of objects(ProjectTagData)
data[].​external_costs[].​project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

data[].​external_costs[].​project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
data[].​external_costs[].​project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

data[].​external_costs[].​project.​origin_space.​idstringrequired
data[].​external_costs[].​project.​origin_space.​namestringrequired
data[].​external_costs[].​project.​teamArray of objects(TeamMemberData)

Project team

data[].​external_costs[].​project.​guestsArray of objects(TeamMemberData)

Project guests

data[].​external_costs[].​project.​computed_fieldsobject
data[].​external_costs[].​statusstring or nullrequired
data[].​external_costs[].​payment_partial_typestring(OfferUnitIntervalType)required
Enum"once""monthly""yearly"
data[].​external_costs[].​payment_partial_intervalinteger or nullrequired

Interval if payment partial type is monthly or `yearly

TypeIntervalDescription
onceanyOnce per offer
monthly1Every month in performance range
monthly3Every 3 months in performance range
monthly6Every 6 monthsin performance range
yearly1Every year in performance range
yearly3Every 3 years in performance range
yearly6Every 6 years in performance range
data[].​external_costs[].​created_atstring(date-time)required
data[].​external_costs[].​updated_atstring or null(date-time)required
data[].​created_atstring(date-time)required
data[].​updated_atstring or null(date-time)required
data[].​deleted_atstring or null(date-time)required
data[].​computed_fieldsobject
linksArray of stringsrequired
metaobjectrequired
meta.​pathstring or nullrequired

Base path for paginator generated URLs.

meta.​per_pageintegerrequired

Number of items shown per page.

meta.​next_cursorstring or nullrequired
meta.​next_cursor_urlstring or nullrequired
meta.​prev_cursorstring or nullrequired
meta.​prev_cursor_urlstring or nullrequired
Response
application/json
{ "data": [ { … } ], "links": [ "string" ], "meta": { "path": "string", "per_page": 0, "next_cursor": "string", "next_cursor_url": "string", "prev_cursor": "string", "prev_cursor_url": "string" } }

Request

Required scopes: outgoing-invoice:read

Security
http or oauth2
Path
idstringrequired
Query
find_bystring

The field to search by

Default "id"
Enum"id""external_id"
originstring

Used if find_by=external_id by default it will use the integration slug

curl -i -X GET \
  'https://api.kanbert.com/api/v1/outgoing-invoices/master/{id}?find_by=id&origin=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OutgoingInvoiceMasterData

Bodyapplication/json
idstringrequired
titlestringrequired
typestring(OutgoingInvoiceMasterType)required
once
If type is once, then the master is a partial plan
recurring1
Recurring every month
recurring3
Recurring every 3 months
recurring6
Recurring every 6 months
recurring12
Recurring every 12 months
Enum"once""recurring1""recurring3""recurring6""recurring12"
performance_range_startstring or null(date-time)required
performance_range_endstring or null(date-time)required
localestringrequired
currencystringrequired
addressstringrequired
address_changedbooleanrequired

If true the user manually overwrote the companies address

companyCompanyData (object) or nullrequired
Any of:
company.​idstringrequired
company.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

company.​external_originstring or nullrequired

If originated from external system origin is added

company.​vendor_identifierstring or nullrequired
company.​company_namestring or nullrequired
company.​localestring or nullrequired
company.​tax_uidstring or nullrequired
company.​taxation_enabledbooleanrequired

Can be used to indicate reverse charge ie

company.​ibanstring or nullrequired
company.​bicstring or nullrequired
company.​emailstring or nullrequired
company.​email_generalstring or nullrequired
company.​phonestring or nullrequired
company.​faxstring or nullrequired
company.​homepagestring or nullrequired
company.​invoices_by_postbooleanrequired
Default false
company.​invoices_by_emailbooleanrequired
Default false
company.​business_fieldBusinessFieldData (object) or nullrequired
Any of:
company.​business_field.​idstringrequired
company.​business_field.​namestringrequired
company.​company_sizeTagData (object) or nullrequired
Any of:
company.​company_size.​idstringrequired
company.​company_size.​titlestringrequired
company.​company_revenueTagData (object) or nullrequired
Any of:
company.​company_revenue.​idstringrequired
company.​company_revenue.​titlestringrequired
company.​person_attention_tostring or nullrequired
company.​address_invoice_titlestring or nullrequired
company.​address_invoice_streetstring or nullrequired
company.​address_invoice_housestring or nullrequired
company.​address_invoice_street2string or nullrequired
company.​address_invoice_zipstring or nullrequired
company.​address_invoice_statestring or nullrequired
company.​address_invoice_townstring or nullrequired
company.​address_invoice_countryCountryData (object) or nullrequired
Any of:
company.​address_invoice_country.​idstringrequired
company.​address_invoice_country.​namestringrequired
company.​address_invoice_country.​codestring(ISO 3166-1 alpha-2)required
company.​address_invoice_is_deliverybooleanrequired
company.​delivery_person_attention_tostring or nullrequired
company.​address_delivery_titlestring or nullrequired
company.​address_delivery_streetstring or nullrequired
company.​address_delivery_housestring or nullrequired
company.​address_delivery_street2string or nullrequired
company.​address_delivery_zipstring or nullrequired
company.​address_delivery_statestring or nullrequired
company.​address_delivery_townstring or nullrequired
company.​address_delivery_countryCountryData (object) or nullrequired
Any of:
company.​address_delivery_country.​idstringrequired
company.​address_delivery_country.​namestringrequired
company.​address_delivery_country.​codestring(ISO 3166-1 alpha-2)required
company.​clientClientData (object) or nullrequired
Any of:
company.​client.​idstringrequired
company.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

company.​client.​external_originstring or nullrequired

If originated from external system origin is added

company.​client.​namestringrequired
company.​client.​shortcodestring or nullrequired
company.​client.​primary_contactUserData (object) or nullrequired
Any of:
company.​client.​primary_contact.​idstringrequired
company.​client.​primary_contact.​first_namestringrequired
company.​client.​primary_contact.​last_namestringrequired
company.​client.​primary_contact.​emailstringrequired
company.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
company.​client.​primary_contact.​spaceobject(SpaceData)required
company.​client.​primary_contact.​space.​idstringrequired
company.​client.​primary_contact.​space.​namestringrequired
company.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

company.​client.​origin_space.​idstringrequired
company.​client.​origin_space.​namestringrequired
company.​tagsArray of objects(TagData)
company.​contactsArray of objects(ContactData)
company.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

company.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
company.​created_atstring(date-time)required
company.​updated_atstring or null(date-time)required
company.​deleted_atstring or null(date-time)required
company.​contact_companyobject(ContactCompanyPivotData)

Added included via relationship (contact -> companies or company -> contacts)

editorUserData (object) or nullrequired
Any of:
editor.​idstringrequired
editor.​first_namestringrequired
editor.​last_namestringrequired
editor.​emailstringrequired
editor.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
editor.​spaceobject(SpaceData)required
editor.​space.​idstringrequired
editor.​space.​namestringrequired
clientClientData (object) or nullrequired
Any of:
client.​idstringrequired
client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

client.​external_originstring or nullrequired

If originated from external system origin is added

client.​namestringrequired
client.​shortcodestring or nullrequired
client.​primary_contactUserData (object) or nullrequired
Any of:
client.​primary_contact.​idstringrequired
client.​primary_contact.​first_namestringrequired
client.​primary_contact.​last_namestringrequired
client.​primary_contact.​emailstringrequired
client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
client.​primary_contact.​spaceobject(SpaceData)required
client.​primary_contact.​space.​idstringrequired
client.​primary_contact.​space.​namestringrequired
client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

client.​origin_space.​idstringrequired
client.​origin_space.​namestringrequired
projectProjectData (object) or nullrequired
Any of:
project.​idstringrequired
project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

project.​external_originstring or nullrequired

If originated from external system origin is added

project.​titlestringrequired
project.​shortcodestringrequired
project.​po_numberstring or nullrequired
project.​project_typeobject(ProjectTypeData)required
project.​project_type.​idstringrequired
project.​project_type.​titlestringrequired
project.​project_type.​shortcodestringrequired
project.​project_type.​colorstringrequired
project.​project_type.​orderintegerrequired
project.​project_type.​is_defaultbooleanrequired
project.​statusstringrequired
project.​is_acquisitionbooleanrequired
project.​is_privatebooleanrequired
project.​start_datestring or null(date)required
project.​end_datestring or null(date)required
project.​clientobject(ClientData)required
project.​client.​idstringrequired
project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

project.​client.​external_originstring or nullrequired

If originated from external system origin is added

project.​client.​namestringrequired
project.​client.​shortcodestring or nullrequired
project.​client.​primary_contactUserData (object) or nullrequired
Any of:
project.​client.​primary_contact.​idstringrequired
project.​client.​primary_contact.​first_namestringrequired
project.​client.​primary_contact.​last_namestringrequired
project.​client.​primary_contact.​emailstringrequired
project.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
project.​client.​primary_contact.​spaceobject(SpaceData)required
project.​client.​primary_contact.​space.​idstringrequired
project.​client.​primary_contact.​space.​namestringrequired
project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

project.​client.​origin_space.​idstringrequired
project.​client.​origin_space.​namestringrequired
project.​tagsArray of objects(ProjectTagData)
project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

project.​origin_space.​idstringrequired
project.​origin_space.​namestringrequired
project.​teamArray of objects(TeamMemberData)

Project team

project.​guestsArray of objects(TeamMemberData)

Project guests

project.​computed_fieldsobject
taxation_enabledbooleanrequired

Can be used to indicate reverse charge ie

sum_netnumberrequired
sum_taxnumberrequired
sum_grossnumberrequired
sum_external_costsnumberrequired
payment_discountnumber or nullrequired

Factor in percentage

discountsArray of objects(DiscountData)required
discounts[].​idstringrequired
discounts[].​titlestringrequired
discounts[].​discount_factornumber or nullrequired

Discount in percent

discounts[].​discount_absolutenumber or nullrequired

Is not calculated with invoices partial_factor in mind

discounts[].​from_parentbooleanrequired

If true, the discount was set in invoice master

discounts[].​is_payment_discountbooleanrequired

If true this discount was granted due to payment discount rules

discounts[].​orderintegerrequired

The order how discounts are applied

line_itemsArray of objects(OutgoingInvoiceLineItemData)required
line_items[].​idstringrequired
line_items[].​titlestringrequired
line_items[].​typestring(AccountingLineItemType)required
Enum"unit""category""page_break"
line_items[].​indentintegerrequired
line_items[].​orderintegerrequired
line_items[].​pricenumberrequired

Is always the full price of the unit (without partial_factor) See partial_factor if element is part of an partial invoice

line_items[].​amountnumberrequired
line_items[].​total_net_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

line_items[].​total_net_without_discountnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

line_items[].​total_netnumberrequired

Including unit discount (not invoice discounts) and partial_factor
See partial_factor if element is part of an partial invoice

line_items[].​total_gross_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

line_items[].​total_gross_without_discountnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

line_items[].​total_grossnumberrequired

Including unit discount (not invoice discounts) and partial_factor
See partial_factor if element is part of an partial invoice

line_items[].​tax_factornumberrequired
line_items[].​metricobject(MetricData)required
line_items[].​metric.​idstringrequired
line_items[].​metric.​titlestringrequired
line_items[].​metric.​title_pluralstringrequired
line_items[].​projectProjectData (object) or nullrequired
Any of:
line_items[].​project.​idstringrequired
line_items[].​project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

line_items[].​project.​external_originstring or nullrequired

If originated from external system origin is added

line_items[].​project.​titlestringrequired
line_items[].​project.​shortcodestringrequired
line_items[].​project.​po_numberstring or nullrequired
line_items[].​project.​project_typeobject(ProjectTypeData)required
line_items[].​project.​project_type.​idstringrequired
line_items[].​project.​project_type.​titlestringrequired
line_items[].​project.​project_type.​shortcodestringrequired
line_items[].​project.​project_type.​colorstringrequired
line_items[].​project.​project_type.​orderintegerrequired
line_items[].​project.​project_type.​is_defaultbooleanrequired
line_items[].​project.​statusstringrequired
line_items[].​project.​is_acquisitionbooleanrequired
line_items[].​project.​is_privatebooleanrequired
line_items[].​project.​start_datestring or null(date)required
line_items[].​project.​end_datestring or null(date)required
line_items[].​project.​clientobject(ClientData)required
line_items[].​project.​client.​idstringrequired
line_items[].​project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

line_items[].​project.​client.​external_originstring or nullrequired

If originated from external system origin is added

line_items[].​project.​client.​namestringrequired
line_items[].​project.​client.​shortcodestring or nullrequired
line_items[].​project.​client.​primary_contactUserData (object) or nullrequired
Any of:
line_items[].​project.​client.​primary_contact.​idstringrequired
line_items[].​project.​client.​primary_contact.​first_namestringrequired
line_items[].​project.​client.​primary_contact.​last_namestringrequired
line_items[].​project.​client.​primary_contact.​emailstringrequired
line_items[].​project.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
line_items[].​project.​client.​primary_contact.​spaceobject(SpaceData)required
line_items[].​project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

line_items[].​project.​client.​origin_space.​idstringrequired
line_items[].​project.​client.​origin_space.​namestringrequired
line_items[].​project.​tagsArray of objects(ProjectTagData)
line_items[].​project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

line_items[].​project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
line_items[].​project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

line_items[].​project.​origin_space.​idstringrequired
line_items[].​project.​origin_space.​namestringrequired
line_items[].​project.​teamArray of objects(TeamMemberData)

Project team

line_items[].​project.​guestsArray of objects(TeamMemberData)

Project guests

line_items[].​project.​computed_fieldsobject
line_items[].​partial_factorinteger or nullrequired

Value in percent. Describes the part of the unit that is included in the invoice

line_items[].​exclude_from_discountbooleanrequired

If true, the unit will be excluded from offer-wide discounts

Default false
line_items[].​discount_factornumber or nullrequired
line_items[].​discount_absolutenumber or nullrequired
line_items[].​discount_boundbooleanrequired

If true, the amount will multiply discount absolute

Default false
line_items[].​purchase_pricenumberrequired
Default 0
line_items[].​purchase_amountnumberrequired
Default 1
line_items[].​purchase_total_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

Default 0
line_items[].​purchase_totalnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

Default 0
line_items[].​purchase_price_boundbooleanrequired

If true, purchase_amount will be in sync with amount

Default false
line_items[].​descriptionstringrequired
line_items[].​payment_partial_typestring(OfferUnitIntervalType)required
Enum"once""monthly""yearly"
line_items[].​payment_partial_intervalinteger or nullrequired

Interval if payment partial type is monthly or `yearly

TypeIntervalDescription
onceanyOnce per offer
monthly1Every month in performance range
monthly3Every 3 months in performance range
monthly6Every 6 monthsin performance range
yearly1Every year in performance range
yearly3Every 3 years in performance range
yearly6Every 6 years in performance range
external_costsArray of objects(ExternalCostData)required

For partial invoices external costs will be empty - these are part of the invoice master plan

external_costs[].​idstringrequired
external_costs[].​titlestringrequired
external_costs[].​typestringrequired
external_costs[].​indentintegerrequired
external_costs[].​orderintegerrequired
external_costs[].​is_creditbooleanrequired

if true this cost is a credit

external_costs[].​is_optionalbooleanrequired
external_costs[].​pricenumberrequired
external_costs[].​amountnumberrequired
external_costs[].​totalnumberrequired
external_costs[].​supplierSupplierData (object) or nullrequired
Any of:
external_costs[].​supplier.​idstringrequired
external_costs[].​supplier.​namestringrequired
external_costs[].​clientClientData (object) or nullrequired
Any of:
external_costs[].​client.​idstringrequired
external_costs[].​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

external_costs[].​client.​external_originstring or nullrequired

If originated from external system origin is added

external_costs[].​client.​namestringrequired
external_costs[].​client.​shortcodestring or nullrequired
external_costs[].​client.​primary_contactUserData (object) or nullrequired
Any of:
external_costs[].​client.​primary_contact.​idstringrequired
external_costs[].​client.​primary_contact.​first_namestringrequired
external_costs[].​client.​primary_contact.​last_namestringrequired
external_costs[].​client.​primary_contact.​emailstringrequired
external_costs[].​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
external_costs[].​client.​primary_contact.​spaceobject(SpaceData)required
external_costs[].​client.​primary_contact.​space.​idstringrequired
external_costs[].​client.​primary_contact.​space.​namestringrequired
external_costs[].​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

external_costs[].​client.​origin_space.​idstringrequired
external_costs[].​client.​origin_space.​namestringrequired
external_costs[].​projectProjectData (object) or nullrequired
Any of:
external_costs[].​project.​idstringrequired
external_costs[].​project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

external_costs[].​project.​external_originstring or nullrequired

If originated from external system origin is added

external_costs[].​project.​titlestringrequired
external_costs[].​project.​shortcodestringrequired
external_costs[].​project.​po_numberstring or nullrequired
external_costs[].​project.​project_typeobject(ProjectTypeData)required
external_costs[].​project.​project_type.​idstringrequired
external_costs[].​project.​project_type.​titlestringrequired
external_costs[].​project.​project_type.​shortcodestringrequired
external_costs[].​project.​project_type.​colorstringrequired
external_costs[].​project.​project_type.​orderintegerrequired
external_costs[].​project.​project_type.​is_defaultbooleanrequired
external_costs[].​project.​statusstringrequired
external_costs[].​project.​is_acquisitionbooleanrequired
external_costs[].​project.​is_privatebooleanrequired
external_costs[].​project.​start_datestring or null(date)required
external_costs[].​project.​end_datestring or null(date)required
external_costs[].​project.​clientobject(ClientData)required
external_costs[].​project.​client.​idstringrequired
external_costs[].​project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

external_costs[].​project.​client.​external_originstring or nullrequired

If originated from external system origin is added

external_costs[].​project.​client.​namestringrequired
external_costs[].​project.​client.​shortcodestring or nullrequired
external_costs[].​project.​client.​primary_contactUserData (object) or nullrequired
Any of:
external_costs[].​project.​client.​primary_contact.​idstringrequired
external_costs[].​project.​client.​primary_contact.​first_namestringrequired
external_costs[].​project.​client.​primary_contact.​last_namestringrequired
external_costs[].​project.​client.​primary_contact.​emailstringrequired
external_costs[].​project.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
external_costs[].​project.​client.​primary_contact.​spaceobject(SpaceData)required
external_costs[].​project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

external_costs[].​project.​client.​origin_space.​idstringrequired
external_costs[].​project.​client.​origin_space.​namestringrequired
external_costs[].​project.​tagsArray of objects(ProjectTagData)
external_costs[].​project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

external_costs[].​project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
external_costs[].​project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

external_costs[].​project.​origin_space.​idstringrequired
external_costs[].​project.​origin_space.​namestringrequired
external_costs[].​project.​teamArray of objects(TeamMemberData)

Project team

external_costs[].​project.​guestsArray of objects(TeamMemberData)

Project guests

external_costs[].​project.​computed_fieldsobject
external_costs[].​statusstring or nullrequired
external_costs[].​payment_partial_typestring(OfferUnitIntervalType)required
Enum"once""monthly""yearly"
external_costs[].​payment_partial_intervalinteger or nullrequired

Interval if payment partial type is monthly or `yearly

TypeIntervalDescription
onceanyOnce per offer
monthly1Every month in performance range
monthly3Every 3 months in performance range
monthly6Every 6 monthsin performance range
yearly1Every year in performance range
yearly3Every 3 years in performance range
yearly6Every 6 years in performance range
external_costs[].​created_atstring(date-time)required
external_costs[].​updated_atstring or null(date-time)required
created_atstring(date-time)required
updated_atstring or null(date-time)required
deleted_atstring or null(date-time)required
computed_fieldsobject
Response
application/json
{ "id": "string", "title": "string", "type": "once", "performance_range_start": "2019-08-24T14:15:22Z", "performance_range_end": "2019-08-24T14:15:22Z", "locale": "string", "currency": "string", "address": "string", "address_changed": true, "company": { "id": "string", "external_id": "string", "external_origin": "string", "vendor_identifier": "string", "company_name": "string", "locale": "string", "tax_uid": "string", "taxation_enabled": true, "iban": "string", "bic": "string", "email": "string", "email_general": "string", "phone": "string", "fax": "string", "homepage": "string", "invoices_by_post": false, "invoices_by_email": false, "business_field": { … }, "company_size": { … }, "company_revenue": { … }, "person_attention_to": "string", "address_invoice_title": "string", "address_invoice_street": "string", "address_invoice_house": "string", "address_invoice_street2": "string", "address_invoice_zip": "string", "address_invoice_state": "string", "address_invoice_town": "string", "address_invoice_country": { … }, "address_invoice_is_delivery": true, "delivery_person_attention_to": "string", "address_delivery_title": "string", "address_delivery_street": "string", "address_delivery_house": "string", "address_delivery_street2": "string", "address_delivery_zip": "string", "address_delivery_state": "string", "address_delivery_town": "string", "address_delivery_country": { … }, "client": { … }, "tags": [ … ], "contacts": [ … ], "custom_fields": "['custom_field_1' => 'value', 'custom_field_2' => true]", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "deleted_at": "2019-08-24T14:15:22Z", "contact_company": { … } }, "editor": { "id": "string", "first_name": "string", "last_name": "string", "email": "string", "type": "user", "space": { … } }, "client": { "id": "string", "external_id": "string", "external_origin": "string", "name": "string", "shortcode": "string", "primary_contact": { … }, "origin_space": { … } }, "project": { "id": "string", "external_id": "string", "external_origin": "string", "title": "string", "shortcode": "string", "po_number": "string", "project_type": { … }, "status": "string", "is_acquisition": true, "is_private": true, "start_date": "2019-08-24", "end_date": "2019-08-24", "client": { … }, "tags": [ … ], "custom_fields": "['custom_field_1' => 'value', 'custom_field_2' => true]", "origin_space": { … }, "team": [ … ], "guests": [ … ], "computed_fields": { … } }, "taxation_enabled": true, "sum_net": 0, "sum_tax": 0, "sum_gross": 0, "sum_external_costs": 0, "payment_discount": 0, "discounts": [ { … } ], "line_items": [ { … } ], "external_costs": [ { … } ], "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "deleted_at": "2019-08-24T14:15:22Z", "computed_fields": { "property1": 0, "property2": 0 } }

Request

Required scopes: outgoing-invoice:read

Security
http or oauth2
Path
idstringrequired
Query
find_bystring

The field to search by

Default "id"
Enum"id""external_id"
originstring

Used if find_by=external_id by default it will use the integration slug

curl -i -X GET \
  'https://api.kanbert.com/api/v1/outgoing-invoices/{id}?find_by=id&origin=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OutgoingInvoiceData

Bodyapplication/json
idstringrequired
external_idstring or nullrequired
external_originstring or nullrequired
master_invoice_idstring or null(OutgoingInvoiceMasterData)required

If invoice is part of a master invoice plan

invoice_numberstring or nullrequired
titlestringrequired
statusstring(OutgoingInvoiceStatus)required
estimate
Invoice is meant as estimate
open
Invoice in draft
bookable
Invoice is ready to be booked
booked
Invoice was booked
Enum"estimate""open""bookable""booked"
payment_statusstring(OutgoingInvoicePaymentStatus)required
Enum"open""partly_paid""paid""cancelled"
is_creditbooleanrequired
Default false
date_of_invoicestring(date-time)required
payment_due_datestring(date-time)required
payment_due_date_orgstring(date-time)required

Is the payment due date originally set

performance_range_startstring or null(date-time)required
performance_range_endstring or null(date-time)required
po_numberstring or nullrequired
referencestring or nullrequired
localestringrequired
currencystringrequired
addressstringrequired
address_changedbooleanrequired

If true the user manually overwrote the companies address

companyCompanyData (object) or nullrequired
Any of:
company.​idstringrequired
company.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

company.​external_originstring or nullrequired

If originated from external system origin is added

company.​vendor_identifierstring or nullrequired
company.​company_namestring or nullrequired
company.​localestring or nullrequired
company.​tax_uidstring or nullrequired
company.​taxation_enabledbooleanrequired

Can be used to indicate reverse charge ie

company.​ibanstring or nullrequired
company.​bicstring or nullrequired
company.​emailstring or nullrequired
company.​email_generalstring or nullrequired
company.​phonestring or nullrequired
company.​faxstring or nullrequired
company.​homepagestring or nullrequired
company.​invoices_by_postbooleanrequired
Default false
company.​invoices_by_emailbooleanrequired
Default false
company.​business_fieldBusinessFieldData (object) or nullrequired
Any of:
company.​business_field.​idstringrequired
company.​business_field.​namestringrequired
company.​company_sizeTagData (object) or nullrequired
Any of:
company.​company_size.​idstringrequired
company.​company_size.​titlestringrequired
company.​company_revenueTagData (object) or nullrequired
Any of:
company.​company_revenue.​idstringrequired
company.​company_revenue.​titlestringrequired
company.​person_attention_tostring or nullrequired
company.​address_invoice_titlestring or nullrequired
company.​address_invoice_streetstring or nullrequired
company.​address_invoice_housestring or nullrequired
company.​address_invoice_street2string or nullrequired
company.​address_invoice_zipstring or nullrequired
company.​address_invoice_statestring or nullrequired
company.​address_invoice_townstring or nullrequired
company.​address_invoice_countryCountryData (object) or nullrequired
Any of:
company.​address_invoice_country.​idstringrequired
company.​address_invoice_country.​namestringrequired
company.​address_invoice_country.​codestring(ISO 3166-1 alpha-2)required
company.​address_invoice_is_deliverybooleanrequired
company.​delivery_person_attention_tostring or nullrequired
company.​address_delivery_titlestring or nullrequired
company.​address_delivery_streetstring or nullrequired
company.​address_delivery_housestring or nullrequired
company.​address_delivery_street2string or nullrequired
company.​address_delivery_zipstring or nullrequired
company.​address_delivery_statestring or nullrequired
company.​address_delivery_townstring or nullrequired
company.​address_delivery_countryCountryData (object) or nullrequired
Any of:
company.​address_delivery_country.​idstringrequired
company.​address_delivery_country.​namestringrequired
company.​address_delivery_country.​codestring(ISO 3166-1 alpha-2)required
company.​clientClientData (object) or nullrequired
Any of:
company.​client.​idstringrequired
company.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

company.​client.​external_originstring or nullrequired

If originated from external system origin is added

company.​client.​namestringrequired
company.​client.​shortcodestring or nullrequired
company.​client.​primary_contactUserData (object) or nullrequired
Any of:
company.​client.​primary_contact.​idstringrequired
company.​client.​primary_contact.​first_namestringrequired
company.​client.​primary_contact.​last_namestringrequired
company.​client.​primary_contact.​emailstringrequired
company.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
company.​client.​primary_contact.​spaceobject(SpaceData)required
company.​client.​primary_contact.​space.​idstringrequired
company.​client.​primary_contact.​space.​namestringrequired
company.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

company.​client.​origin_space.​idstringrequired
company.​client.​origin_space.​namestringrequired
company.​tagsArray of objects(TagData)
company.​contactsArray of objects(ContactData)
company.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

company.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
company.​created_atstring(date-time)required
company.​updated_atstring or null(date-time)required
company.​deleted_atstring or null(date-time)required
company.​contact_companyobject(ContactCompanyPivotData)

Added included via relationship (contact -> companies or company -> contacts)

editorUserData (object) or nullrequired
Any of:
editor.​idstringrequired
editor.​first_namestringrequired
editor.​last_namestringrequired
editor.​emailstringrequired
editor.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
editor.​spaceobject(SpaceData)required
editor.​space.​idstringrequired
editor.​space.​namestringrequired
clientobject(ClientData)required
client.​idstringrequired
client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

client.​external_originstring or nullrequired

If originated from external system origin is added

client.​namestringrequired
client.​shortcodestring or nullrequired
client.​primary_contactUserData (object) or nullrequired
Any of:
client.​primary_contact.​idstringrequired
client.​primary_contact.​first_namestringrequired
client.​primary_contact.​last_namestringrequired
client.​primary_contact.​emailstringrequired
client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
client.​primary_contact.​spaceobject(SpaceData)required
client.​primary_contact.​space.​idstringrequired
client.​primary_contact.​space.​namestringrequired
client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

client.​origin_space.​idstringrequired
client.​origin_space.​namestringrequired
projectProjectData (object) or nullrequired
Any of:
project.​idstringrequired
project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

project.​external_originstring or nullrequired

If originated from external system origin is added

project.​titlestringrequired
project.​shortcodestringrequired
project.​po_numberstring or nullrequired
project.​project_typeobject(ProjectTypeData)required
project.​project_type.​idstringrequired
project.​project_type.​titlestringrequired
project.​project_type.​shortcodestringrequired
project.​project_type.​colorstringrequired
project.​project_type.​orderintegerrequired
project.​project_type.​is_defaultbooleanrequired
project.​statusstringrequired
project.​is_acquisitionbooleanrequired
project.​is_privatebooleanrequired
project.​start_datestring or null(date)required
project.​end_datestring or null(date)required
project.​clientobject(ClientData)required
project.​client.​idstringrequired
project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

project.​client.​external_originstring or nullrequired

If originated from external system origin is added

project.​client.​namestringrequired
project.​client.​shortcodestring or nullrequired
project.​client.​primary_contactUserData (object) or nullrequired
Any of:
project.​client.​primary_contact.​idstringrequired
project.​client.​primary_contact.​first_namestringrequired
project.​client.​primary_contact.​last_namestringrequired
project.​client.​primary_contact.​emailstringrequired
project.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
project.​client.​primary_contact.​spaceobject(SpaceData)required
project.​client.​primary_contact.​space.​idstringrequired
project.​client.​primary_contact.​space.​namestringrequired
project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

project.​client.​origin_space.​idstringrequired
project.​client.​origin_space.​namestringrequired
project.​tagsArray of objects(ProjectTagData)
project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

project.​origin_space.​idstringrequired
project.​origin_space.​namestringrequired
project.​teamArray of objects(TeamMemberData)

Project team

project.​guestsArray of objects(TeamMemberData)

Project guests

project.​computed_fieldsobject
taxation_enabledbooleanrequired

Can be used to indicate reverse charge ie

sum_netnumberrequired
sum_taxnumberrequired
sum_grossnumberrequired
sum_external_costsnumberrequired
partial_indentstring or nullrequired

Indicator for partial invoices <currentInvoice>/<numberOfInvoices>

partial_factornumber or nullrequired

Factor in percentage for partial invoices

payment_discount_due_datestring or null(date-time)required
payment_discountnumber or nullrequired

Factor in percentage

discountsArray of objects(DiscountData)required
discounts[].​idstringrequired
discounts[].​titlestringrequired
discounts[].​discount_factornumber or nullrequired

Discount in percent

discounts[].​discount_absolutenumber or nullrequired

Is not calculated with invoices partial_factor in mind

discounts[].​from_parentbooleanrequired

If true, the discount was set in invoice master

discounts[].​is_payment_discountbooleanrequired

If true this discount was granted due to payment discount rules

discounts[].​orderintegerrequired

The order how discounts are applied

line_itemsArray of objects(OutgoingInvoiceLineItemData)required
line_items[].​idstringrequired
line_items[].​titlestringrequired
line_items[].​typestring(AccountingLineItemType)required
Enum"unit""category""page_break"
line_items[].​indentintegerrequired
line_items[].​orderintegerrequired
line_items[].​pricenumberrequired

Is always the full price of the unit (without partial_factor) See partial_factor if element is part of an partial invoice

line_items[].​amountnumberrequired
line_items[].​total_net_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

line_items[].​total_net_without_discountnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

line_items[].​total_netnumberrequired

Including unit discount (not invoice discounts) and partial_factor
See partial_factor if element is part of an partial invoice

line_items[].​total_gross_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

line_items[].​total_gross_without_discountnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

line_items[].​total_grossnumberrequired

Including unit discount (not invoice discounts) and partial_factor
See partial_factor if element is part of an partial invoice

line_items[].​tax_factornumberrequired
line_items[].​metricobject(MetricData)required
line_items[].​metric.​idstringrequired
line_items[].​metric.​titlestringrequired
line_items[].​metric.​title_pluralstringrequired
line_items[].​projectProjectData (object) or nullrequired
Any of:
line_items[].​project.​idstringrequired
line_items[].​project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

line_items[].​project.​external_originstring or nullrequired

If originated from external system origin is added

line_items[].​project.​titlestringrequired
line_items[].​project.​shortcodestringrequired
line_items[].​project.​po_numberstring or nullrequired
line_items[].​project.​project_typeobject(ProjectTypeData)required
line_items[].​project.​project_type.​idstringrequired
line_items[].​project.​project_type.​titlestringrequired
line_items[].​project.​project_type.​shortcodestringrequired
line_items[].​project.​project_type.​colorstringrequired
line_items[].​project.​project_type.​orderintegerrequired
line_items[].​project.​project_type.​is_defaultbooleanrequired
line_items[].​project.​statusstringrequired
line_items[].​project.​is_acquisitionbooleanrequired
line_items[].​project.​is_privatebooleanrequired
line_items[].​project.​start_datestring or null(date)required
line_items[].​project.​end_datestring or null(date)required
line_items[].​project.​clientobject(ClientData)required
line_items[].​project.​client.​idstringrequired
line_items[].​project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

line_items[].​project.​client.​external_originstring or nullrequired

If originated from external system origin is added

line_items[].​project.​client.​namestringrequired
line_items[].​project.​client.​shortcodestring or nullrequired
line_items[].​project.​client.​primary_contactUserData (object) or nullrequired
Any of:
line_items[].​project.​client.​primary_contact.​idstringrequired
line_items[].​project.​client.​primary_contact.​first_namestringrequired
line_items[].​project.​client.​primary_contact.​last_namestringrequired
line_items[].​project.​client.​primary_contact.​emailstringrequired
line_items[].​project.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
line_items[].​project.​client.​primary_contact.​spaceobject(SpaceData)required
line_items[].​project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

line_items[].​project.​client.​origin_space.​idstringrequired
line_items[].​project.​client.​origin_space.​namestringrequired
line_items[].​project.​tagsArray of objects(ProjectTagData)
line_items[].​project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

line_items[].​project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
line_items[].​project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

line_items[].​project.​origin_space.​idstringrequired
line_items[].​project.​origin_space.​namestringrequired
line_items[].​project.​teamArray of objects(TeamMemberData)

Project team

line_items[].​project.​guestsArray of objects(TeamMemberData)

Project guests

line_items[].​project.​computed_fieldsobject
line_items[].​partial_factorinteger or nullrequired

Value in percent. Describes the part of the unit that is included in the invoice

line_items[].​exclude_from_discountbooleanrequired

If true, the unit will be excluded from offer-wide discounts

Default false
line_items[].​discount_factornumber or nullrequired
line_items[].​discount_absolutenumber or nullrequired
line_items[].​discount_boundbooleanrequired

If true, the amount will multiply discount absolute

Default false
line_items[].​purchase_pricenumberrequired
Default 0
line_items[].​purchase_amountnumberrequired
Default 1
line_items[].​purchase_total_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

Default 0
line_items[].​purchase_totalnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

Default 0
line_items[].​purchase_price_boundbooleanrequired

If true, purchase_amount will be in sync with amount

Default false
line_items[].​descriptionstringrequired
line_items[].​payment_partial_typestring(OfferUnitIntervalType)required
Enum"once""monthly""yearly"
line_items[].​payment_partial_intervalinteger or nullrequired

Interval if payment partial type is monthly or `yearly

TypeIntervalDescription
onceanyOnce per offer
monthly1Every month in performance range
monthly3Every 3 months in performance range
monthly6Every 6 monthsin performance range
yearly1Every year in performance range
yearly3Every 3 years in performance range
yearly6Every 6 years in performance range
external_costsArray of objects(ExternalCostData)required

For partial invoices external costs will be empty - these are part of the invoice master plan

external_costs[].​idstringrequired
external_costs[].​titlestringrequired
external_costs[].​typestringrequired
external_costs[].​indentintegerrequired
external_costs[].​orderintegerrequired
external_costs[].​is_creditbooleanrequired

if true this cost is a credit

external_costs[].​is_optionalbooleanrequired
external_costs[].​pricenumberrequired
external_costs[].​amountnumberrequired
external_costs[].​totalnumberrequired
external_costs[].​supplierSupplierData (object) or nullrequired
Any of:
external_costs[].​supplier.​idstringrequired
external_costs[].​supplier.​namestringrequired
external_costs[].​clientClientData (object) or nullrequired
Any of:
external_costs[].​client.​idstringrequired
external_costs[].​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

external_costs[].​client.​external_originstring or nullrequired

If originated from external system origin is added

external_costs[].​client.​namestringrequired
external_costs[].​client.​shortcodestring or nullrequired
external_costs[].​client.​primary_contactUserData (object) or nullrequired
Any of:
external_costs[].​client.​primary_contact.​idstringrequired
external_costs[].​client.​primary_contact.​first_namestringrequired
external_costs[].​client.​primary_contact.​last_namestringrequired
external_costs[].​client.​primary_contact.​emailstringrequired
external_costs[].​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
external_costs[].​client.​primary_contact.​spaceobject(SpaceData)required
external_costs[].​client.​primary_contact.​space.​idstringrequired
external_costs[].​client.​primary_contact.​space.​namestringrequired
external_costs[].​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

external_costs[].​client.​origin_space.​idstringrequired
external_costs[].​client.​origin_space.​namestringrequired
external_costs[].​projectProjectData (object) or nullrequired
Any of:
external_costs[].​project.​idstringrequired
external_costs[].​project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

external_costs[].​project.​external_originstring or nullrequired

If originated from external system origin is added

external_costs[].​project.​titlestringrequired
external_costs[].​project.​shortcodestringrequired
external_costs[].​project.​po_numberstring or nullrequired
external_costs[].​project.​project_typeobject(ProjectTypeData)required
external_costs[].​project.​project_type.​idstringrequired
external_costs[].​project.​project_type.​titlestringrequired
external_costs[].​project.​project_type.​shortcodestringrequired
external_costs[].​project.​project_type.​colorstringrequired
external_costs[].​project.​project_type.​orderintegerrequired
external_costs[].​project.​project_type.​is_defaultbooleanrequired
external_costs[].​project.​statusstringrequired
external_costs[].​project.​is_acquisitionbooleanrequired
external_costs[].​project.​is_privatebooleanrequired
external_costs[].​project.​start_datestring or null(date)required
external_costs[].​project.​end_datestring or null(date)required
external_costs[].​project.​clientobject(ClientData)required
external_costs[].​project.​client.​idstringrequired
external_costs[].​project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

external_costs[].​project.​client.​external_originstring or nullrequired

If originated from external system origin is added

external_costs[].​project.​client.​namestringrequired
external_costs[].​project.​client.​shortcodestring or nullrequired
external_costs[].​project.​client.​primary_contactUserData (object) or nullrequired
Any of:
external_costs[].​project.​client.​primary_contact.​idstringrequired
external_costs[].​project.​client.​primary_contact.​first_namestringrequired
external_costs[].​project.​client.​primary_contact.​last_namestringrequired
external_costs[].​project.​client.​primary_contact.​emailstringrequired
external_costs[].​project.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
external_costs[].​project.​client.​primary_contact.​spaceobject(SpaceData)required
external_costs[].​project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

external_costs[].​project.​client.​origin_space.​idstringrequired
external_costs[].​project.​client.​origin_space.​namestringrequired
external_costs[].​project.​tagsArray of objects(ProjectTagData)
external_costs[].​project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

external_costs[].​project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
external_costs[].​project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

external_costs[].​project.​origin_space.​idstringrequired
external_costs[].​project.​origin_space.​namestringrequired
external_costs[].​project.​teamArray of objects(TeamMemberData)

Project team

external_costs[].​project.​guestsArray of objects(TeamMemberData)

Project guests

external_costs[].​project.​computed_fieldsobject
external_costs[].​statusstring or nullrequired
external_costs[].​payment_partial_typestring(OfferUnitIntervalType)required
Enum"once""monthly""yearly"
external_costs[].​payment_partial_intervalinteger or nullrequired

Interval if payment partial type is monthly or `yearly

TypeIntervalDescription
onceanyOnce per offer
monthly1Every month in performance range
monthly3Every 3 months in performance range
monthly6Every 6 monthsin performance range
yearly1Every year in performance range
yearly3Every 3 years in performance range
yearly6Every 6 years in performance range
external_costs[].​created_atstring(date-time)required
external_costs[].​updated_atstring or null(date-time)required
created_atstring(date-time)required
updated_atstring or null(date-time)required
deleted_atstring or null(date-time)required
computed_fieldsobject
Response
application/json
{ "id": "string", "external_id": "string", "external_origin": "string", "master_invoice_id": "string", "invoice_number": "string", "title": "string", "status": "estimate", "payment_status": "open", "is_credit": false, "date_of_invoice": "2019-08-24T14:15:22Z", "payment_due_date": "2019-08-24T14:15:22Z", "payment_due_date_org": "2019-08-24T14:15:22Z", "performance_range_start": "2019-08-24T14:15:22Z", "performance_range_end": "2019-08-24T14:15:22Z", "po_number": "string", "reference": "string", "locale": "string", "currency": "string", "address": "string", "address_changed": true, "company": { "id": "string", "external_id": "string", "external_origin": "string", "vendor_identifier": "string", "company_name": "string", "locale": "string", "tax_uid": "string", "taxation_enabled": true, "iban": "string", "bic": "string", "email": "string", "email_general": "string", "phone": "string", "fax": "string", "homepage": "string", "invoices_by_post": false, "invoices_by_email": false, "business_field": { … }, "company_size": { … }, "company_revenue": { … }, "person_attention_to": "string", "address_invoice_title": "string", "address_invoice_street": "string", "address_invoice_house": "string", "address_invoice_street2": "string", "address_invoice_zip": "string", "address_invoice_state": "string", "address_invoice_town": "string", "address_invoice_country": { … }, "address_invoice_is_delivery": true, "delivery_person_attention_to": "string", "address_delivery_title": "string", "address_delivery_street": "string", "address_delivery_house": "string", "address_delivery_street2": "string", "address_delivery_zip": "string", "address_delivery_state": "string", "address_delivery_town": "string", "address_delivery_country": { … }, "client": { … }, "tags": [ … ], "contacts": [ … ], "custom_fields": "['custom_field_1' => 'value', 'custom_field_2' => true]", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "deleted_at": "2019-08-24T14:15:22Z", "contact_company": { … } }, "editor": { "id": "string", "first_name": "string", "last_name": "string", "email": "string", "type": "user", "space": { … } }, "client": { "id": "string", "external_id": "string", "external_origin": "string", "name": "string", "shortcode": "string", "primary_contact": { … }, "origin_space": { … } }, "project": { "id": "string", "external_id": "string", "external_origin": "string", "title": "string", "shortcode": "string", "po_number": "string", "project_type": { … }, "status": "string", "is_acquisition": true, "is_private": true, "start_date": "2019-08-24", "end_date": "2019-08-24", "client": { … }, "tags": [ … ], "custom_fields": "['custom_field_1' => 'value', 'custom_field_2' => true]", "origin_space": { … }, "team": [ … ], "guests": [ … ], "computed_fields": { … } }, "taxation_enabled": true, "sum_net": 0, "sum_tax": 0, "sum_gross": 0, "sum_external_costs": 0, "partial_indent": "1/2", "partial_factor": 0, "payment_discount_due_date": "2019-08-24T14:15:22Z", "payment_discount": 0, "discounts": [ { … } ], "line_items": [ { … } ], "external_costs": [ { … } ], "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "deleted_at": "2019-08-24T14:15:22Z", "computed_fields": { "property1": 0, "property2": 0 } }

Request

Required scopes: outgoing-invoice:read

Security
http or oauth2
Path
idstringrequired
Query
find_bystring

The field to search by

Default "id"
Enum"id""external_id"
originstring

Used if find_by=external_id by default it will use the integration slug

sortstring

Available sorts are title, price, total_net_base, total_net_without_discount, total_net, total_gross_base, total_gross_without_discount, total_gross, purchase_total, purchase_total_base, purchase_price, created_at, updated_at.
You can sort by multiple options by separating them with a comma. To sort in descending order, use - sign in front of the sort, for example: -title.

Example: sort=sort=-created_at,title
page[size]integer

The number of results that will be returned per page.

Default 30
page[cursor]string

The cursor to start the pagination from.

filterstring

Allowed filter fields (with allowed operators):

FieldTypeOperators
titlestringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
pricefloateq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, isnull, isnotnull, notnull
amountfloateq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, isnull, isnotnull, notnull
tax_factorfloateq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, isnull, isnotnull, notnull
project.idid<ProjectData>eq, ne, neq, in, nin, notin, isnull, isnotnull, notnull
project.titlestringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
project.external_idstringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
project.shortcodestringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
total_net_basecurrencyeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, contains, like, startswith, endswith, isnull, isnotnull, notnull
total_net_without_discountcurrencyeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, contains, like, startswith, endswith, isnull, isnotnull, notnull
total_netcurrencyeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, contains, like, startswith, endswith, isnull, isnotnull, notnull
total_gross_basecurrencyeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, contains, like, startswith, endswith, isnull, isnotnull, notnull
total_gross_without_discountcurrencyeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, contains, like, startswith, endswith, isnull, isnotnull, notnull
total_grosscurrencyeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, contains, like, startswith, endswith, isnull, isnotnull, notnull
purchase_pricecurrencyeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, contains, like, startswith, endswith, isnull, isnotnull, notnull
purchase_total_basecurrencyeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, contains, like, startswith, endswith, isnull, isnotnull, notnull
purchase_totalcurrencyeq, ne, neq, lt, lte, le, gt, gte, ge, in, nin, notin, contains, like, startswith, endswith, isnull, isnotnull, notnull
typeenum<AccountingLineItemType>eq, ne, neq, in, nin, notin
metric.idid<MetricData>eq, ne, neq, in, nin, notin, isnull, isnotnull, notnull
metric.titlestringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull

Filtering expression. Accepts either JSON (array/tree of conditions) or a readable string DSL.

You can check the full syntax at Docs Filtering section.

Special values:

  • me.id — current authenticated user id (usable on fields of type id). Example: id eq me.id
  • now — current date-time. Example: dueOn lt now
  • sow/eow — start/end of week. Examples: dueOn gt sow, dueOn lt eow
  • som/eom — start/end of month. Examples: dueOn gt som, dueOn lt eom
  • today — special date for today; with eq it expands to the whole day range. Example: dueOn eq today
  • today±Nd — relative day offset. Examples: today-30d, today+5d.
Example: filter=title contains "Acme" and (created_at >= "2024-01-01" or client.name contains "Corp")
curl -i -X GET \
  'https://api.kanbert.com/api/v1/outgoing-invoices/{id}/line-items?find_by=id&origin=string&sort=sort%3D-created_at%2Ctitle&page%5Bsize%5D=30&page%5Bcursor%5D=string&filter=title+contains+%22Acme%22+and+%28created_at+%3E%3D+%222024-01-01%22+or+client.name+contains+%22Corp%22%29' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

The cursor paginated collection of OutgoingInvoiceLineItemData

Bodyapplication/json
dataArray of objects(OutgoingInvoiceLineItemData)required

The list of items

data[].​idstringrequired
data[].​titlestringrequired
data[].​typestring(AccountingLineItemType)required
Enum"unit""category""page_break"
data[].​indentintegerrequired
data[].​orderintegerrequired
data[].​pricenumberrequired

Is always the full price of the unit (without partial_factor) See partial_factor if element is part of an partial invoice

data[].​amountnumberrequired
data[].​total_net_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

data[].​total_net_without_discountnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

data[].​total_netnumberrequired

Including unit discount (not invoice discounts) and partial_factor
See partial_factor if element is part of an partial invoice

data[].​total_gross_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

data[].​total_gross_without_discountnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

data[].​total_grossnumberrequired

Including unit discount (not invoice discounts) and partial_factor
See partial_factor if element is part of an partial invoice

data[].​tax_factornumberrequired
data[].​metricobject(MetricData)required
data[].​metric.​idstringrequired
data[].​metric.​titlestringrequired
data[].​metric.​title_pluralstringrequired
data[].​projectProjectData (object) or nullrequired
Any of:
data[].​project.​idstringrequired
data[].​project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

data[].​project.​external_originstring or nullrequired

If originated from external system origin is added

data[].​project.​titlestringrequired
data[].​project.​shortcodestringrequired
data[].​project.​po_numberstring or nullrequired
data[].​project.​project_typeobject(ProjectTypeData)required
data[].​project.​project_type.​idstringrequired
data[].​project.​project_type.​titlestringrequired
data[].​project.​project_type.​shortcodestringrequired
data[].​project.​project_type.​colorstringrequired
data[].​project.​project_type.​orderintegerrequired
data[].​project.​project_type.​is_defaultbooleanrequired
data[].​project.​statusstringrequired
data[].​project.​is_acquisitionbooleanrequired
data[].​project.​is_privatebooleanrequired
data[].​project.​start_datestring or null(date)required
data[].​project.​end_datestring or null(date)required
data[].​project.​clientobject(ClientData)required
data[].​project.​client.​idstringrequired
data[].​project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​project.​client.​external_originstring or nullrequired

If originated from external system origin is added

data[].​project.​client.​namestringrequired
data[].​project.​client.​shortcodestring or nullrequired
data[].​project.​client.​primary_contactUserData (object) or nullrequired
Any of:
data[].​project.​client.​primary_contact.​idstringrequired
data[].​project.​client.​primary_contact.​first_namestringrequired
data[].​project.​client.​primary_contact.​last_namestringrequired
data[].​project.​client.​primary_contact.​emailstringrequired
data[].​project.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
data[].​project.​client.​primary_contact.​spaceobject(SpaceData)required
data[].​project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

data[].​project.​client.​origin_space.​idstringrequired
data[].​project.​client.​origin_space.​namestringrequired
data[].​project.​tagsArray of objects(ProjectTagData)
data[].​project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

data[].​project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
data[].​project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

data[].​project.​origin_space.​idstringrequired
data[].​project.​origin_space.​namestringrequired
data[].​project.​teamArray of objects(TeamMemberData)

Project team

data[].​project.​guestsArray of objects(TeamMemberData)

Project guests

data[].​project.​computed_fieldsobject
data[].​partial_factorinteger or nullrequired

Value in percent. Describes the part of the unit that is included in the invoice

data[].​exclude_from_discountbooleanrequired

If true, the unit will be excluded from offer-wide discounts

Default false
data[].​discount_factornumber or nullrequired
data[].​discount_absolutenumber or nullrequired
data[].​discount_boundbooleanrequired

If true, the amount will multiply discount absolute

Default false
data[].​purchase_pricenumberrequired
Default 0
data[].​purchase_amountnumberrequired
Default 1
data[].​purchase_total_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

Default 0
data[].​purchase_totalnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

Default 0
data[].​purchase_price_boundbooleanrequired

If true, purchase_amount will be in sync with amount

Default false
data[].​descriptionstringrequired
data[].​payment_partial_typestring(OfferUnitIntervalType)required
Enum"once""monthly""yearly"
data[].​payment_partial_intervalinteger or nullrequired

Interval if payment partial type is monthly or `yearly

TypeIntervalDescription
onceanyOnce per offer
monthly1Every month in performance range
monthly3Every 3 months in performance range
monthly6Every 6 monthsin performance range
yearly1Every year in performance range
yearly3Every 3 years in performance range
yearly6Every 6 years in performance range
linksArray of stringsrequired
metaobjectrequired
meta.​pathstring or nullrequired

Base path for paginator generated URLs.

meta.​per_pageintegerrequired

Number of items shown per page.

meta.​next_cursorstring or nullrequired
meta.​next_cursor_urlstring or nullrequired
meta.​prev_cursorstring or nullrequired
meta.​prev_cursor_urlstring or nullrequired
Response
application/json
{ "data": [ { … } ], "links": [ "string" ], "meta": { "path": "string", "per_page": 0, "next_cursor": "string", "next_cursor_url": "string", "prev_cursor": "string", "prev_cursor_url": "string" } }

Request

Required scopes: outgoing-invoice:upload

Endpoint can be used to upload outgoing invoices not created within Kanbert.

Be careful:
Invoice Enumeration & consistency is in your responsibility.
Make sure not to interfere with the invoice numbering of Kanbert.

Security
http or oauth2
Bodymultipart/form-datarequired
external_idstring or null<= 255 characters

Can be used to add an identifier from an external system, must be unique within integration (integration's slug)

external_originstring<= 255 characters

If not set, integration's slug will be used as default

client_idstringrequired
titlestringrequired
statusstringrequired

Allowed values: booked

Value"booked"
invoice_numberstring

Required if status is booked.
We do check whether an invoice with the same invoice_number exists already.
We do not check if the invoice interferes with invoice number cycles in Kanbert.

date_of_invoicestring(date-time)required
performance_range_startstring(date-time)required
performance_range_endstring(date-time)required
payment_due_datestring(date-time)required
booked_atstring(date-time)
currencystringrequired

Allowed values: EUR

Value"EUR"
sum_netnumberrequired
sum_taxnumber

Can be used to indicate reverse charge

Default 0
taxation_enabledboolean

Can be used to indicate reverse charge

Default true
is_creditboolean
addressstring
referencestring
po_numberstring
project_idstring
company_idstring
editor_idstring
file_urlstring(uri)

A public url to download the invoice PDF from - either file_url or file are required

filestring(binary)

PDF to upload - Max: 15MB - either file_url or file are required

vatsArray of objects
curl -i -X POST \
  https://api.kanbert.com/api/v1/outgoing-invoices/external \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: multipart/form-data' \
  -F external_id=string \
  -F external_origin=string \
  -F client_id=string \
  -F title=string \
  -F status=booked \
  -F invoice_number=string \
  -F date_of_invoice=2019-08-24T14:15:22Z \
  -F performance_range_start=2019-08-24T14:15:22Z \
  -F performance_range_end=2019-08-24T14:15:22Z \
  -F payment_due_date=2019-08-24T14:15:22Z \
  -F booked_at=2019-08-24T14:15:22Z \
  -F currency=EUR \
  -F sum_net=0 \
  -F sum_tax=0 \
  -F taxation_enabled=true \
  -F is_credit=true \
  -F address=string \
  -F reference=string \
  -F po_number=string \
  -F project_id=string \
  -F company_id=string \
  -F editor_id=string \
  -F file_url=http://example.com \
  -F file=string \
  -F 'vats[0][vat]=0' \
  -F 'vats[0][value]=0'

Responses

OutgoingInvoiceData

Bodyapplication/json
idstringrequired
external_idstring or nullrequired
external_originstring or nullrequired
master_invoice_idstring or null(OutgoingInvoiceMasterData)required

If invoice is part of a master invoice plan

invoice_numberstring or nullrequired
titlestringrequired
statusstring(OutgoingInvoiceStatus)required
estimate
Invoice is meant as estimate
open
Invoice in draft
bookable
Invoice is ready to be booked
booked
Invoice was booked
Enum"estimate""open""bookable""booked"
payment_statusstring(OutgoingInvoicePaymentStatus)required
Enum"open""partly_paid""paid""cancelled"
is_creditbooleanrequired
Default false
date_of_invoicestring(date-time)required
payment_due_datestring(date-time)required
payment_due_date_orgstring(date-time)required

Is the payment due date originally set

performance_range_startstring or null(date-time)required
performance_range_endstring or null(date-time)required
po_numberstring or nullrequired
referencestring or nullrequired
localestringrequired
currencystringrequired
addressstringrequired
address_changedbooleanrequired

If true the user manually overwrote the companies address

companyCompanyData (object) or nullrequired
Any of:
company.​idstringrequired
company.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

company.​external_originstring or nullrequired

If originated from external system origin is added

company.​vendor_identifierstring or nullrequired
company.​company_namestring or nullrequired
company.​localestring or nullrequired
company.​tax_uidstring or nullrequired
company.​taxation_enabledbooleanrequired

Can be used to indicate reverse charge ie

company.​ibanstring or nullrequired
company.​bicstring or nullrequired
company.​emailstring or nullrequired
company.​email_generalstring or nullrequired
company.​phonestring or nullrequired
company.​faxstring or nullrequired
company.​homepagestring or nullrequired
company.​invoices_by_postbooleanrequired
Default false
company.​invoices_by_emailbooleanrequired
Default false
company.​business_fieldBusinessFieldData (object) or nullrequired
Any of:
company.​business_field.​idstringrequired
company.​business_field.​namestringrequired
company.​company_sizeTagData (object) or nullrequired
Any of:
company.​company_size.​idstringrequired
company.​company_size.​titlestringrequired
company.​company_revenueTagData (object) or nullrequired
Any of:
company.​company_revenue.​idstringrequired
company.​company_revenue.​titlestringrequired
company.​person_attention_tostring or nullrequired
company.​address_invoice_titlestring or nullrequired
company.​address_invoice_streetstring or nullrequired
company.​address_invoice_housestring or nullrequired
company.​address_invoice_street2string or nullrequired
company.​address_invoice_zipstring or nullrequired
company.​address_invoice_statestring or nullrequired
company.​address_invoice_townstring or nullrequired
company.​address_invoice_countryCountryData (object) or nullrequired
Any of:
company.​address_invoice_country.​idstringrequired
company.​address_invoice_country.​namestringrequired
company.​address_invoice_country.​codestring(ISO 3166-1 alpha-2)required
company.​address_invoice_is_deliverybooleanrequired
company.​delivery_person_attention_tostring or nullrequired
company.​address_delivery_titlestring or nullrequired
company.​address_delivery_streetstring or nullrequired
company.​address_delivery_housestring or nullrequired
company.​address_delivery_street2string or nullrequired
company.​address_delivery_zipstring or nullrequired
company.​address_delivery_statestring or nullrequired
company.​address_delivery_townstring or nullrequired
company.​address_delivery_countryCountryData (object) or nullrequired
Any of:
company.​address_delivery_country.​idstringrequired
company.​address_delivery_country.​namestringrequired
company.​address_delivery_country.​codestring(ISO 3166-1 alpha-2)required
company.​clientClientData (object) or nullrequired
Any of:
company.​client.​idstringrequired
company.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

company.​client.​external_originstring or nullrequired

If originated from external system origin is added

company.​client.​namestringrequired
company.​client.​shortcodestring or nullrequired
company.​client.​primary_contactUserData (object) or nullrequired
Any of:
company.​client.​primary_contact.​idstringrequired
company.​client.​primary_contact.​first_namestringrequired
company.​client.​primary_contact.​last_namestringrequired
company.​client.​primary_contact.​emailstringrequired
company.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
company.​client.​primary_contact.​spaceobject(SpaceData)required
company.​client.​primary_contact.​space.​idstringrequired
company.​client.​primary_contact.​space.​namestringrequired
company.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

company.​client.​origin_space.​idstringrequired
company.​client.​origin_space.​namestringrequired
company.​tagsArray of objects(TagData)
company.​contactsArray of objects(ContactData)
company.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

company.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
company.​created_atstring(date-time)required
company.​updated_atstring or null(date-time)required
company.​deleted_atstring or null(date-time)required
company.​contact_companyobject(ContactCompanyPivotData)

Added included via relationship (contact -> companies or company -> contacts)

editorUserData (object) or nullrequired
Any of:
editor.​idstringrequired
editor.​first_namestringrequired
editor.​last_namestringrequired
editor.​emailstringrequired
editor.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
editor.​spaceobject(SpaceData)required
editor.​space.​idstringrequired
editor.​space.​namestringrequired
clientobject(ClientData)required
client.​idstringrequired
client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

client.​external_originstring or nullrequired

If originated from external system origin is added

client.​namestringrequired
client.​shortcodestring or nullrequired
client.​primary_contactUserData (object) or nullrequired
Any of:
client.​primary_contact.​idstringrequired
client.​primary_contact.​first_namestringrequired
client.​primary_contact.​last_namestringrequired
client.​primary_contact.​emailstringrequired
client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
client.​primary_contact.​spaceobject(SpaceData)required
client.​primary_contact.​space.​idstringrequired
client.​primary_contact.​space.​namestringrequired
client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

client.​origin_space.​idstringrequired
client.​origin_space.​namestringrequired
projectProjectData (object) or nullrequired
Any of:
project.​idstringrequired
project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

project.​external_originstring or nullrequired

If originated from external system origin is added

project.​titlestringrequired
project.​shortcodestringrequired
project.​po_numberstring or nullrequired
project.​project_typeobject(ProjectTypeData)required
project.​project_type.​idstringrequired
project.​project_type.​titlestringrequired
project.​project_type.​shortcodestringrequired
project.​project_type.​colorstringrequired
project.​project_type.​orderintegerrequired
project.​project_type.​is_defaultbooleanrequired
project.​statusstringrequired
project.​is_acquisitionbooleanrequired
project.​is_privatebooleanrequired
project.​start_datestring or null(date)required
project.​end_datestring or null(date)required
project.​clientobject(ClientData)required
project.​client.​idstringrequired
project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

project.​client.​external_originstring or nullrequired

If originated from external system origin is added

project.​client.​namestringrequired
project.​client.​shortcodestring or nullrequired
project.​client.​primary_contactUserData (object) or nullrequired
Any of:
project.​client.​primary_contact.​idstringrequired
project.​client.​primary_contact.​first_namestringrequired
project.​client.​primary_contact.​last_namestringrequired
project.​client.​primary_contact.​emailstringrequired
project.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
project.​client.​primary_contact.​spaceobject(SpaceData)required
project.​client.​primary_contact.​space.​idstringrequired
project.​client.​primary_contact.​space.​namestringrequired
project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

project.​client.​origin_space.​idstringrequired
project.​client.​origin_space.​namestringrequired
project.​tagsArray of objects(ProjectTagData)
project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

project.​origin_space.​idstringrequired
project.​origin_space.​namestringrequired
project.​teamArray of objects(TeamMemberData)

Project team

project.​guestsArray of objects(TeamMemberData)

Project guests

project.​computed_fieldsobject
taxation_enabledbooleanrequired

Can be used to indicate reverse charge ie

sum_netnumberrequired
sum_taxnumberrequired
sum_grossnumberrequired
sum_external_costsnumberrequired
partial_indentstring or nullrequired

Indicator for partial invoices <currentInvoice>/<numberOfInvoices>

partial_factornumber or nullrequired

Factor in percentage for partial invoices

payment_discount_due_datestring or null(date-time)required
payment_discountnumber or nullrequired

Factor in percentage

discountsArray of objects(DiscountData)required
discounts[].​idstringrequired
discounts[].​titlestringrequired
discounts[].​discount_factornumber or nullrequired

Discount in percent

discounts[].​discount_absolutenumber or nullrequired

Is not calculated with invoices partial_factor in mind

discounts[].​from_parentbooleanrequired

If true, the discount was set in invoice master

discounts[].​is_payment_discountbooleanrequired

If true this discount was granted due to payment discount rules

discounts[].​orderintegerrequired

The order how discounts are applied

line_itemsArray of objects(OutgoingInvoiceLineItemData)required
line_items[].​idstringrequired
line_items[].​titlestringrequired
line_items[].​typestring(AccountingLineItemType)required
Enum"unit""category""page_break"
line_items[].​indentintegerrequired
line_items[].​orderintegerrequired
line_items[].​pricenumberrequired

Is always the full price of the unit (without partial_factor) See partial_factor if element is part of an partial invoice

line_items[].​amountnumberrequired
line_items[].​total_net_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

line_items[].​total_net_without_discountnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

line_items[].​total_netnumberrequired

Including unit discount (not invoice discounts) and partial_factor
See partial_factor if element is part of an partial invoice

line_items[].​total_gross_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

line_items[].​total_gross_without_discountnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

line_items[].​total_grossnumberrequired

Including unit discount (not invoice discounts) and partial_factor
See partial_factor if element is part of an partial invoice

line_items[].​tax_factornumberrequired
line_items[].​metricobject(MetricData)required
line_items[].​metric.​idstringrequired
line_items[].​metric.​titlestringrequired
line_items[].​metric.​title_pluralstringrequired
line_items[].​projectProjectData (object) or nullrequired
Any of:
line_items[].​project.​idstringrequired
line_items[].​project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

line_items[].​project.​external_originstring or nullrequired

If originated from external system origin is added

line_items[].​project.​titlestringrequired
line_items[].​project.​shortcodestringrequired
line_items[].​project.​po_numberstring or nullrequired
line_items[].​project.​project_typeobject(ProjectTypeData)required
line_items[].​project.​project_type.​idstringrequired
line_items[].​project.​project_type.​titlestringrequired
line_items[].​project.​project_type.​shortcodestringrequired
line_items[].​project.​project_type.​colorstringrequired
line_items[].​project.​project_type.​orderintegerrequired
line_items[].​project.​project_type.​is_defaultbooleanrequired
line_items[].​project.​statusstringrequired
line_items[].​project.​is_acquisitionbooleanrequired
line_items[].​project.​is_privatebooleanrequired
line_items[].​project.​start_datestring or null(date)required
line_items[].​project.​end_datestring or null(date)required
line_items[].​project.​clientobject(ClientData)required
line_items[].​project.​client.​idstringrequired
line_items[].​project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

line_items[].​project.​client.​external_originstring or nullrequired

If originated from external system origin is added

line_items[].​project.​client.​namestringrequired
line_items[].​project.​client.​shortcodestring or nullrequired
line_items[].​project.​client.​primary_contactUserData (object) or nullrequired
Any of:
line_items[].​project.​client.​primary_contact.​idstringrequired
line_items[].​project.​client.​primary_contact.​first_namestringrequired
line_items[].​project.​client.​primary_contact.​last_namestringrequired
line_items[].​project.​client.​primary_contact.​emailstringrequired
line_items[].​project.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
line_items[].​project.​client.​primary_contact.​spaceobject(SpaceData)required
line_items[].​project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

line_items[].​project.​client.​origin_space.​idstringrequired
line_items[].​project.​client.​origin_space.​namestringrequired
line_items[].​project.​tagsArray of objects(ProjectTagData)
line_items[].​project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

line_items[].​project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
line_items[].​project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

line_items[].​project.​origin_space.​idstringrequired
line_items[].​project.​origin_space.​namestringrequired
line_items[].​project.​teamArray of objects(TeamMemberData)

Project team

line_items[].​project.​guestsArray of objects(TeamMemberData)

Project guests

line_items[].​project.​computed_fieldsobject
line_items[].​partial_factorinteger or nullrequired

Value in percent. Describes the part of the unit that is included in the invoice

line_items[].​exclude_from_discountbooleanrequired

If true, the unit will be excluded from offer-wide discounts

Default false
line_items[].​discount_factornumber or nullrequired
line_items[].​discount_absolutenumber or nullrequired
line_items[].​discount_boundbooleanrequired

If true, the amount will multiply discount absolute

Default false
line_items[].​purchase_pricenumberrequired
Default 0
line_items[].​purchase_amountnumberrequired
Default 1
line_items[].​purchase_total_basenumberrequired

Excluding partial_factor and all discounts
See partial_factor if element is part of an partial invoice

Default 0
line_items[].​purchase_totalnumberrequired

Including partial_factor, excluding all discounts
See partial_factor if element is part of an partial invoice

Default 0
line_items[].​purchase_price_boundbooleanrequired

If true, purchase_amount will be in sync with amount

Default false
line_items[].​descriptionstringrequired
line_items[].​payment_partial_typestring(OfferUnitIntervalType)required
Enum"once""monthly""yearly"
line_items[].​payment_partial_intervalinteger or nullrequired

Interval if payment partial type is monthly or `yearly

TypeIntervalDescription
onceanyOnce per offer
monthly1Every month in performance range
monthly3Every 3 months in performance range
monthly6Every 6 monthsin performance range
yearly1Every year in performance range
yearly3Every 3 years in performance range
yearly6Every 6 years in performance range
external_costsArray of objects(ExternalCostData)required

For partial invoices external costs will be empty - these are part of the invoice master plan

external_costs[].​idstringrequired
external_costs[].​titlestringrequired
external_costs[].​typestringrequired
external_costs[].​indentintegerrequired
external_costs[].​orderintegerrequired
external_costs[].​is_creditbooleanrequired

if true this cost is a credit

external_costs[].​is_optionalbooleanrequired
external_costs[].​pricenumberrequired
external_costs[].​amountnumberrequired
external_costs[].​totalnumberrequired
external_costs[].​supplierSupplierData (object) or nullrequired
Any of:
external_costs[].​supplier.​idstringrequired
external_costs[].​supplier.​namestringrequired
external_costs[].​clientClientData (object) or nullrequired
Any of:
external_costs[].​client.​idstringrequired
external_costs[].​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

external_costs[].​client.​external_originstring or nullrequired

If originated from external system origin is added

external_costs[].​client.​namestringrequired
external_costs[].​client.​shortcodestring or nullrequired
external_costs[].​client.​primary_contactUserData (object) or nullrequired
Any of:
external_costs[].​client.​primary_contact.​idstringrequired
external_costs[].​client.​primary_contact.​first_namestringrequired
external_costs[].​client.​primary_contact.​last_namestringrequired
external_costs[].​client.​primary_contact.​emailstringrequired
external_costs[].​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
external_costs[].​client.​primary_contact.​spaceobject(SpaceData)required
external_costs[].​client.​primary_contact.​space.​idstringrequired
external_costs[].​client.​primary_contact.​space.​namestringrequired
external_costs[].​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

external_costs[].​client.​origin_space.​idstringrequired
external_costs[].​client.​origin_space.​namestringrequired
external_costs[].​projectProjectData (object) or nullrequired
Any of:
external_costs[].​project.​idstringrequired
external_costs[].​project.​external_idstring or nullrequired

Can be used to add an identifier to the project from an external system, must be unique

external_costs[].​project.​external_originstring or nullrequired

If originated from external system origin is added

external_costs[].​project.​titlestringrequired
external_costs[].​project.​shortcodestringrequired
external_costs[].​project.​po_numberstring or nullrequired
external_costs[].​project.​project_typeobject(ProjectTypeData)required
external_costs[].​project.​project_type.​idstringrequired
external_costs[].​project.​project_type.​titlestringrequired
external_costs[].​project.​project_type.​shortcodestringrequired
external_costs[].​project.​project_type.​colorstringrequired
external_costs[].​project.​project_type.​orderintegerrequired
external_costs[].​project.​project_type.​is_defaultbooleanrequired
external_costs[].​project.​statusstringrequired
external_costs[].​project.​is_acquisitionbooleanrequired
external_costs[].​project.​is_privatebooleanrequired
external_costs[].​project.​start_datestring or null(date)required
external_costs[].​project.​end_datestring or null(date)required
external_costs[].​project.​clientobject(ClientData)required
external_costs[].​project.​client.​idstringrequired
external_costs[].​project.​client.​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

external_costs[].​project.​client.​external_originstring or nullrequired

If originated from external system origin is added

external_costs[].​project.​client.​namestringrequired
external_costs[].​project.​client.​shortcodestring or nullrequired
external_costs[].​project.​client.​primary_contactUserData (object) or nullrequired
Any of:
external_costs[].​project.​client.​primary_contact.​idstringrequired
external_costs[].​project.​client.​primary_contact.​first_namestringrequired
external_costs[].​project.​client.​primary_contact.​last_namestringrequired
external_costs[].​project.​client.​primary_contact.​emailstringrequired
external_costs[].​project.​client.​primary_contact.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
external_costs[].​project.​client.​primary_contact.​spaceobject(SpaceData)required
external_costs[].​project.​client.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the client is shared from, if null client is not shared

external_costs[].​project.​client.​origin_space.​idstringrequired
external_costs[].​project.​client.​origin_space.​namestringrequired
external_costs[].​project.​tagsArray of objects(ProjectTagData)
external_costs[].​project.​custom_fieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

external_costs[].​project.​custom_fields.​property name*string or boolean or integer or nulladditional property
Any of:
string
external_costs[].​project.​origin_spaceSpaceData (object) or nullrequired
Any of:

Shared space which the project is shared from, if null project is not shared

external_costs[].​project.​origin_space.​idstringrequired
external_costs[].​project.​origin_space.​namestringrequired
external_costs[].​project.​teamArray of objects(TeamMemberData)

Project team

external_costs[].​project.​guestsArray of objects(TeamMemberData)

Project guests

external_costs[].​project.​computed_fieldsobject
external_costs[].​statusstring or nullrequired
external_costs[].​payment_partial_typestring(OfferUnitIntervalType)required
Enum"once""monthly""yearly"
external_costs[].​payment_partial_intervalinteger or nullrequired

Interval if payment partial type is monthly or `yearly

TypeIntervalDescription
onceanyOnce per offer
monthly1Every month in performance range
monthly3Every 3 months in performance range
monthly6Every 6 monthsin performance range
yearly1Every year in performance range
yearly3Every 3 years in performance range
yearly6Every 6 years in performance range
external_costs[].​created_atstring(date-time)required
external_costs[].​updated_atstring or null(date-time)required
created_atstring(date-time)required
updated_atstring or null(date-time)required
deleted_atstring or null(date-time)required
computed_fieldsobject
Response
application/json
{ "id": "string", "external_id": "string", "external_origin": "string", "master_invoice_id": "string", "invoice_number": "string", "title": "string", "status": "estimate", "payment_status": "open", "is_credit": false, "date_of_invoice": "2019-08-24T14:15:22Z", "payment_due_date": "2019-08-24T14:15:22Z", "payment_due_date_org": "2019-08-24T14:15:22Z", "performance_range_start": "2019-08-24T14:15:22Z", "performance_range_end": "2019-08-24T14:15:22Z", "po_number": "string", "reference": "string", "locale": "string", "currency": "string", "address": "string", "address_changed": true, "company": { "id": "string", "external_id": "string", "external_origin": "string", "vendor_identifier": "string", "company_name": "string", "locale": "string", "tax_uid": "string", "taxation_enabled": true, "iban": "string", "bic": "string", "email": "string", "email_general": "string", "phone": "string", "fax": "string", "homepage": "string", "invoices_by_post": false, "invoices_by_email": false, "business_field": { … }, "company_size": { … }, "company_revenue": { … }, "person_attention_to": "string", "address_invoice_title": "string", "address_invoice_street": "string", "address_invoice_house": "string", "address_invoice_street2": "string", "address_invoice_zip": "string", "address_invoice_state": "string", "address_invoice_town": "string", "address_invoice_country": { … }, "address_invoice_is_delivery": true, "delivery_person_attention_to": "string", "address_delivery_title": "string", "address_delivery_street": "string", "address_delivery_house": "string", "address_delivery_street2": "string", "address_delivery_zip": "string", "address_delivery_state": "string", "address_delivery_town": "string", "address_delivery_country": { … }, "client": { … }, "tags": [ … ], "contacts": [ … ], "custom_fields": "['custom_field_1' => 'value', 'custom_field_2' => true]", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "deleted_at": "2019-08-24T14:15:22Z", "contact_company": { … } }, "editor": { "id": "string", "first_name": "string", "last_name": "string", "email": "string", "type": "user", "space": { … } }, "client": { "id": "string", "external_id": "string", "external_origin": "string", "name": "string", "shortcode": "string", "primary_contact": { … }, "origin_space": { … } }, "project": { "id": "string", "external_id": "string", "external_origin": "string", "title": "string", "shortcode": "string", "po_number": "string", "project_type": { … }, "status": "string", "is_acquisition": true, "is_private": true, "start_date": "2019-08-24", "end_date": "2019-08-24", "client": { … }, "tags": [ … ], "custom_fields": "['custom_field_1' => 'value', 'custom_field_2' => true]", "origin_space": { … }, "team": [ … ], "guests": [ … ], "computed_fields": { … } }, "taxation_enabled": true, "sum_net": 0, "sum_tax": 0, "sum_gross": 0, "sum_external_costs": 0, "partial_indent": "1/2", "partial_factor": 0, "payment_discount_due_date": "2019-08-24T14:15:22Z", "payment_discount": 0, "discounts": [ { … } ], "line_items": [ { … } ], "external_costs": [ { … } ], "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "deleted_at": "2019-08-24T14:15:22Z", "computed_fields": { "property1": 0, "property2": 0 } }

Request

Required scopes: outgoing-invoice:read

Security
http or oauth2
Path
idstringrequired

The ID of the invoice to be downloaded.

Query
find_bystring

The field to search by

Default "id"
Enum"id""external_id"
originstring

Used if find_by=external_id by default it will use the integration slug

curl -i -X GET \
  'https://api.kanbert.com/api/v1/outgoing-invoices/{id}/pdf?find_by=id&origin=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Headers
Content-Dispositionstringrequired
Example: "attachment"
Bodyapplication/octet-stream
string(binary)
Response
No content
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Schemas