Appearance
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
}
]
}| Field | Type | Required | Description |
|---|---|---|---|
data | object[] | yes | The companies of the workspace. |
data[].id | uuid | yes | Identifies the company. |
data[].domain | string | yes | The email domain that stands for this company. This is the value the customer filter takes. |
data[].name | string | yes | Display name of the company. |
data[].meeting_count | integer | yes | Meetings 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
| Code | Meaning |
|---|---|
401 | No key, or a key that is not valid. |
403 | The key is missing the scope this endpoint needs. |
503 | The 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. |