Menu

API reference · Reports

Data sources

reports · data_sources · 1 operation

GET/v1/reports/data-sources

List the data sources a report can read

reports.data_sources.list

ReadIdempotentSince 2026-11-01

Lists the platform connections of the organization, or of one of its accounts (target_org_id), with the data_source_id that goes in a data_source_mapping or in a block's data_source_id (e.g. google_ads:1234567890), the display name, the external id, the account currency and whether it is inherited from the workspace. Filter by platforms. Use it before reports.instances.generate or reports.templates.deploy to map each slot of the template. Requires view access to Reports. With Google Ads, Google Business Profile, LinkedIn, TikTok or YouTube, their terms limit it through the API and the MCP: what they do not allow answers 403 platform_terms_restricted, and their records are left out of the response (the permissions guide lists what each platform allows).

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

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

Parameters

target_org_idstringqueryoptional

The connections of this account of the workspace (to map a report made for it); without it, this organization's.

platformsarray<enum>queryoptional

Only these platforms (google_ads, meta_ads, google_analytics, google_search_console, google_business_profile, facebook_page, instagram, tiktok_ads, tiktok, linkedin_ads, linkedin_page, youtube).

Values: google_ads, meta_ads, google_analytics, google_search_console, google_business_profile, facebook_page, instagram, tiktok_ads, tiktok, linkedin_ads, linkedin_page, youtube

Response

dataarray<object>
has_morefalse

Errors

Example

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