I'mBoard API Docs

A dashboard represents a data visualization configuration within a board. Dashboards are nested under reports — every dashboard belongs to a report via its reportId field.

Relationship to Reports

A report is the top-level container (e.g. "Q2 2025 Board Report")
A dashboard is a specific visualization within that report (e.g. "Financial Overview", "HR Summary")
Every dashboard has a reportId linking it to its parent report
A report can contain multiple dashboards of different types

Endpoints

Method	Path	Description
`GET`	`/api/v1/boards/:boardId/reports/:reportId/dashboards`	List dashboards
`GET`	`/api/v1/boards/:boardId/reports/:reportId/dashboards/:dashboardId`	Get a dashboard

Dashboard Object

{
  "object": "dashboard",
  "id": "60d5ec49f1a2c8b1f8e4e1f1",
  "boardId": "60d5ec49f1a2c8b1f8e4e1a1",
  "reportId": "60d5ec49f1a2c8b1f8e4e1e1",
  "dashboardType": "financial",
  "title": null,
  "latestVersionId": "60d5ec49f1a2c8b1f8e4e1f2",
  "createdByUserId": "507f1f77bcf86cd799439011",
  "createdAt": "2025-06-20T10:00:00.000Z",
  "updatedAt": "2025-07-01T09:00:00.000Z"
}

Fields

Field	Type	Description
`object`	`"dashboard"`	Always `"dashboard"`
`id`	string	Opaque dashboard ID
`boardId`	string \| null	The board this dashboard belongs to
`reportId`	string	The parent report's ID
`dashboardType`	string	Type: `financial`, `hr`, `sales`, `fundraising`, etc.
`title`	string \| null	Dashboard title
`latestVersionId`	string \| null	ID of the most recent dashboard version
`createdByUserId`	string	ID of the user who created the dashboard
`createdAt`	string	ISO-8601 timestamp
`updatedAt`	string	ISO-8601 timestamp

List Dashboards

GET /api/v1/boards/:boardId/reports/:reportId/dashboards

Supports filtering by dashboardType. See Pagination, Filtering & Sorting.

Example

curl -s "https://app.imboard.ai/api/v1/boards/BOARD_ID/reports/REPORT_ID/dashboards?dashboardType=financial" \
  -H "Authorization: Bearer imb_pat_YOUR_TOKEN" | jq

Get a Dashboard

GET /api/v1/boards/:boardId/reports/:reportId/dashboards/:dashboardId

Dashboards