Labels · Activity · API reference

GET/v1/activity/labels

List activity labels

activity.labels.list

ReadIdempotentSince 2026-11-01

Lists the organization's activity labels (id, name, color) in their manual order, paginated by cursor (limit up to 200), to set label_ids on entries (activity.entries.create and update ignore ids that are not here). Every label comes, ordered by order ascending: a label saved without a position counts as 0 (and comes back with order 0), and ties go by id. That holds up to 200 labels; an organization with more is listed by its stored position, and a label without one is left out. Labels are created, edited and deleted in the app. An Account has its own labels. Cost: one read per label of the organization (up to 200) plus one.

Scope: activity:read
Permission: View the module
MCP tool: activity_labels_listOn the full surface; on the compact one, mb_execute_operation with id: "activity.labels.list".

Declared cost: up to 203 reads and 0 writes per call (they count against the daily quota).

Parameters

limitintegerqueryoptional

How many items this page brings at most (see the maximum and the default in the schema).

Default: 50

cursorstringqueryoptional

The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.

Response

dataarray<object>

has_moreboolean

next_cursorstring

Errors

invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Example

curl "https://api.mb-suite.com/v1/activity/labels" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl "https://api.mb-suite.com/v1/activity/labels" \
  -H "Authorization: Bearer $MB_TEST_KEY"