Skip to content
/
CompanyData

Kanbert (v1)

Download OpenAPI description
api.json
api.yaml
Languages
Servers
https://api.kanbert.com/api/v1

Users

Operations

Clients

Operations

Projects

Operations

Tasks

Operations
Webhooks

Task Comments

Operations
Webhooks

Efforts

Operations

Contacts

Operations

Companies

Operations
Webhooks

Offers

Operations

Outgoing Invoices

Operations

Payments

Operations

Usergroups & Teams

Operations

Settings

Operations

Integration

Operations

Files

Operations

Custom Fields

Operations

Webhook Management

Operations

Schemas

Schemas

CommentData

idstringrequired
external_idstring or nullrequired
external_originstring or nullrequired

If originated from external system origin is added

parent_comment_idstring or nullrequired
parent_commentCommentData (object) or null
Any of:
object CommentData Recursive
taskTaskData (object) or null
Any of:
sub_commentsArray of objects(CommentData)required
authorobject(UserData)required
author.​idstringrequired
author.​first_namestringrequired
author.​last_namestringrequired
author.​emailstringrequired
author.​typestring(UserType)required
Enum"user""guest""tax_advisor""integration"
author.​spaceobject(SpaceData)required
author.​space.​idstringrequired
author.​space.​namestringrequired
commentstring or nullrequired
attachementsArray of objects(FileData)required
Default []
attachements[].​idstringrequired
attachements[].​file_namestringrequired
attachements[].​mime_typestringrequired
attachements[].​sizeintegerrequired

File size in bytes

attachements[].​entity_idstringrequired

ID of the entity that the file belongs to

attachements[].​entity_typestringrequired

Type of the entity that the file belongs to

attachements[].​created_atstringrequired
is_publicbooleanrequired

If false, the task is only visible to the project team - not guest users

created_atstring or null(date-time)required
updated_atstring or null(date-time)required
{
  "id": "string",
  "external_id": "string",
  "external_origin": "string",
  "parent_comment_id": "string",
  "parent_comment": {},
  "task": {
    "id": "string",
    "project_id": "string",
    "client_id": "string",
    "parent_task_id": "string",
    "external_id": "string",
    "external_origin": "string",
    "uri": "string",
    "title": "string",
    "description": "string",
    "status": "Backlog",
    "type": "string",
    "estimated_hours": 0,
    "is_onhold": true,
    "is_public": true,
    "due_date": "2019-08-24",
    "due_date_settings": { … },
    "assignee": { … },
    "priorityOption": { … },
    "phase": { … },
    "milestone": { … },
    "epic": { … },
    "parent_task": {},
    "attachements": [],
    "watchers": [ … ],
    "sub_tasks": [ … ],
    "completed_at": "2019-08-24T14:15:22Z",
    "closed_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "created_at": "2019-08-24T14:15:22Z",
    "list_sorting": 0
  },
  "sub_comments": [
    {}
  ],
  "author": {
    "id": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "string",
    "type": "user",
    "space": { … }
  },
  "comment": "string",
  "attachements": [],
  "is_public": true,
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

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"
}