Menu

API reference · Reports

Labels

reports · labels · 1 operation

GET/v1/reports/labels

List the labels of report templates or reports

reports.labels.list

ReadIdempotentSince 2026-11-01

Lists the labels this organization uses to organize its report templates (of: templates, the default) or its editable reports and report instances (of: reports): id, name, color and order, in the screen's order (up to 200). Use the ids in label_ids of reports.templates.create/update, reports.reports.create/update or reports.instances.update; an id that is not here is label_unknown. Labels are created and edited in MB Suite. Requires view access to Reports.

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

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

Parameters

ofenumqueryoptional

templates (report templates, default) or reports (editable reports and report instances).

Values: templates, reports · Default: "templates"

Response

dataarray<object>

The labels, in the screen's order.

Errors

Example

curl "https://api.mb-suite.com/v1/reports/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/reports/labels" \
  -H "Authorization: Bearer $MB_TEST_KEY"