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
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Schemas

CompanyData

idstringrequired
external_idstring or nullrequired

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

external_originstring or nullrequired

If originated from external system origin is added

vendor_identifierstring or nullrequired
company_namestring or nullrequired
localestring or nullrequired
tax_uidstring or nullrequired
taxation_enabledbooleanrequired

Can be used to indicate reverse charge ie

ibanstring or nullrequired
bicstring or nullrequired
emailstring or nullrequired
email_generalstring or nullrequired
phonestring or nullrequired
faxstring or nullrequired
homepagestring or nullrequired
invoices_by_postbooleanrequired
Default false
invoices_by_emailbooleanrequired
Default false
business_fieldBusinessFieldData (object) or nullrequired
Any of:
business_field.​idstringrequired
business_field.​namestringrequired
company_sizeTagData (object) or nullrequired
Any of:
company_size.​idstringrequired
company_size.​titlestringrequired
company_revenueTagData (object) or nullrequired
Any of:
company_revenue.​idstringrequired
company_revenue.​titlestringrequired
person_attention_tostring or nullrequired
address_invoice_titlestring or nullrequired
address_invoice_streetstring or nullrequired
address_invoice_housestring or nullrequired
address_invoice_street2string or nullrequired
address_invoice_zipstring or nullrequired
address_invoice_statestring or nullrequired
address_invoice_townstring or nullrequired
address_invoice_countryCountryData (object) or nullrequired
Any of:
address_invoice_country.​idstringrequired
address_invoice_country.​namestringrequired
address_invoice_country.​codestring(ISO 3166-1 alpha-2)required
address_invoice_is_deliverybooleanrequired
delivery_person_attention_tostring or nullrequired
address_delivery_titlestring or nullrequired
address_delivery_streetstring or nullrequired
address_delivery_housestring or nullrequired
address_delivery_street2string or nullrequired
address_delivery_zipstring or nullrequired
address_delivery_statestring or nullrequired
address_delivery_townstring or nullrequired
address_delivery_countryCountryData (object) or nullrequired
Any of:
address_delivery_country.​idstringrequired
address_delivery_country.​namestringrequired
address_delivery_country.​codestring(ISO 3166-1 alpha-2)required
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
tagsArray of objects(TagData)
contactsArray of objects(ContactData)
custom_fieldsobjectrequired

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

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

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

{ "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": { "id": "string", "name": "string" }, "company_size": { "id": "string", "title": "string" }, "company_revenue": { "id": "string", "title": "string" }, "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": { "id": "string", "name": "string", "code": "string" }, "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": { "id": "string", "name": "string", "code": "string" }, "client": { "id": "string", "external_id": "string", "external_origin": "string", "name": "string", "shortcode": "string", "primary_contact": {}, "origin_space": {} }, "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": { "position": "string" } }

ContactCompanyPivotData

positionstringrequired
{ "position": "string" }

ContactData

idstringrequired
external_idstring or nullrequired

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

external_originstring or nullrequired

If originated from external system origin is added

genderstring or nullrequired
first_namestring or nullrequired
last_namestring or nullrequired
titlestring or nullrequired
title_suffixstring or nullrequired
positionstring or nullrequired
localestring or nullrequired
birthdaystring or null(date)required
faxstring or nullrequired
telephonestring or nullrequired
telephone_privatestring or nullrequired
mobilestring or nullrequired
mobile_privatestring or nullrequired
emailstring or null(email)required
email_privatestring or null(email)required
address_streetstring or nullrequired
address_housestring or nullrequired
address_street2string or nullrequired
address_zipstring or nullrequired
address_statestring or nullrequired
address_townstring or nullrequired
address_countryCountryData (object) or nullrequired
Any of:
address_country.​idstringrequired
address_country.​namestringrequired
address_country.​codestring(ISO 3166-1 alpha-2)required
ownerUserData (object) or nullrequired
Any of:
owner.​idstringrequired
owner.​first_namestringrequired
owner.​last_namestringrequired
owner.​emailstringrequired
owner.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
owner.​spaceobject(SpaceData)required
owner.​space.​idstringrequired
owner.​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
companiesArray of objects(CompanyData)
custom_fieldsobjectrequired

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

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

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

{ "id": "string", "external_id": "string", "external_origin": "string", "gender": "string", "first_name": "string", "last_name": "string", "title": "string", "title_suffix": "string", "position": "string", "locale": "string", "birthday": "2019-08-24", "fax": "string", "telephone": "string", "telephone_private": "string", "mobile": "string", "mobile_private": "string", "email": "user@example.com", "email_private": "user@example.com", "address_street": "string", "address_house": "string", "address_street2": "string", "address_zip": "string", "address_state": "string", "address_town": "string", "address_country": { "id": "string", "name": "string", "code": "string" }, "owner": { "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": {} }, "companies": [ {} ], "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": { "position": "string" } }