Skip to content

Companies of the workspace

GET /api/v1/customers meetings:read

The valid values for the customer filter on /meetings. This is master data, so it is not narrowed to the person.

Response 200

The companies, with domain and meeting count. No pagination.

Example response

json
{
  "data": [
    {
      "id": "e07b6d13-84af-4c92-b5d7-0a9e1f83c246",
      "domain": "company.example",
      "name": "Company Example GmbH",
      "meeting_count": 12
    }
  ]
}
FieldTypeRequiredDescription
dataobject[]yesThe companies of the workspace.
data[].iduuidyesIdentifies the company.
data[].domainstringyesThe email domain that stands for this company. This is the value the customer filter takes.
data[].namestringyesDisplay name of the company.
data[].meeting_countintegeryesMeetings tagged with this company in the workspace. Deliberately NOT narrowed to the person — the number can count meetings a personal key is not allowed to read.

Other answers

CodeMeaning
401No key, or a key that is not valid.
403The key is missing the scope this endpoint needs.
503The endpoint does not exist on this deployment yet, because a database change has not been applied. A temporary state, not a mistake in your request.

Protoki — EU/GDPR-compliant meeting notetaker.