{"title":"Analytics API overview","url":"https://jonas-paprotka.de/docs/dev-itpro/api-analytics/api-analytics-overview/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-analytics/api-analytics-overview, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-analytics/api-analytics-overview","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Overview of the Analytics API in Dynamics 365 Business Central.","date":"2026-06-12","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Why use the Analytics API","slug":"why-use-the-analytics-api","at":312,"chars":223},{"level":2,"title":"Power BI apps and the Analytics API","slug":"power-bi-apps-and-the-analytics-api","at":535,"chars":815},{"level":2,"title":"Analytics APIs by Power BI app","slug":"analytics-apis-by-power-bi-app","at":1350,"chars":3532},{"level":2,"title":"Endpoint pattern","slug":"endpoint-pattern","at":4882,"chars":413},{"level":2,"title":"Authentication and authorization","slug":"authentication-and-authorization","at":5295,"chars":146},{"level":2,"title":"Next steps","slug":"next-steps","at":5441,"chars":237},{"level":2,"title":"Related information","slug":"related-information","at":5678,"chars":536}],"text":"The Analytics API for Business Central provides read-only endpoints that are optimized as data sources for Power BI apps and reports.\nUse this API to extract analytical and reporting data. The Analytics API isn't intended for transactional scenarios, and it doesn't support create, update, or delete operations.\n## Why use the Analytics API\n Provides read-only datasets for reporting and analysis.\n Supports Power BI app and custom Power BI report scenarios.\n Uses the same OAuth-based API access model as other Business Central APIs.\n## Power BI apps and the Analytics API\nThe standard Power BI apps for Business Central use the Analytics API for reading data. In the articles below, you can learn more about how each API is used for KPIs in different functional areas.\nIf you want to analyze ...|Learn more in...\nFinance|Finance KPI overview</finance-powerbi-kpis>\nSales|Sales Power BI app semantic model</sales-powerbi-app-semantic-model><br>Sales KPI overview</sales-powerbi-sales-kpis>\nPurchasing|Purchasing KPI overview</purchases-powerbi-kpis>\nInventory|Inventory KPI overview</inventory-powerbi-kpis><br>Inventory Valuation KPI overview</inventory-valuation-powerbi-kpis>\nProjects|Projects KPI overview</projects-powerbi-kpis>\nManufacturing|/manufacturing-powerbi-kpis\nSustainability|Sustainability KPI overview</sustainability-powerbi-kpis>\n## Analytics APIs by Power BI app\nThe following table shows which Power BI app uses each Analytics API entity.\nAPI|Used for analyzing\nabcAnalysisSetup|Inventory\naccountCategory|Finance\nassemblyHeader|Manufacturing\nassemblyLine|Manufacturing\nbalanceSheetGeneralLedgerEntry|Finance\nbin|Inventory\ncalendarEntry|Manufacturing\ncapacityLedgerEntry|Manufacturing\ncloseIncomeStmtSourceCode|Finance\ncloseOpportunityCode|Sales\nclosingGeneralLedgerEntry|Finance\ncontact|Sales\ncustomer|Finance, Sales\ncustomerLedgerEntry|Finance\ndateSetup|Finance\ndimension|Finance, Sales, Purchasing, Inventory, Manufacturing, Projects, Sustainability\ndimensionSetEntry|Finance, Sales, Purchasing, Inventory, Manufacturing, Projects, Sustainability\ndynamicDimension|Finance\nfromBinWarehouseJournalLine|Inventory\ngeneralLedgerAccount|Finance\ngeneralLedgerAccountCategory|Finance\ngeneralLedgerBudget|Finance\ngeneralLedgerBudgetEntry|Finance\ngeneralLedgerSetup|Finance\nincomeStatementGeneralLedgerEntry|Finance\nincomeStmtGeneralLedgerEntry|Finance\ninventoryAdjustmentEntryOrder|Inventory\ninventoryProdOrderComponentLine|Manufacturing, Inventory\ninventoryProdOrderLine|Manufacturing, Inventory\nitem|Sales, Purchasing, Inventory, Manufacturing, Projects\nitemBudget|Sales\nitemCategory|Sales, Inventory\nitemJobPlanningLine|Projects\nitemLedgerEntry|Inventory, Sales\nitemOutstandingPurchaseLine|Purchasing\nitemOutstandingSalesLine|Sales\nitemReceivedNotInvoicedPurchaseLine|Purchasing\nitemShippedNotInvoicedSalesLine|Sales\nitemValueEntry|Inventory\njob|Projects\njobLedgerEntry|Projects\njobOutstandingPurchaseLine|Projects\njobPlanningLine|Projects\njobReceivedNotInvoicedPurchaseLine|Projects\njobTask|Projects\nlocation|Sales, Purchasing, Inventory, Manufacturing, Projects\nmachineCenter|Manufacturing\nmanufacturingProdOrderComponent|Manufacturing\nmanufacturingProdOrderLines|Manufacturing\nmanufacturingProductionOrder|Manufacturing\nmanufacturingSetup|Manufacturing\nmanufacturingValueEntry|Manufacturing\nopportunity|Sales\nopportunityEntry|Sales\norderServiceLine|Sales\noutstandingPurchaseLine|Purchasing\noutstandingSalesLine|Sales\npbiCountryRegion|Sustainability\npbiEmissionFee|Sustainability\npbiEmployee|Sustainability\npbiEmployeeAbsence|Sustainability\npbiEmployeeLedgerEntry|Sustainability\npbiEmployeeQualification|Sustainability\npbiResponsibilityCentre|Sustainability\npbiSustainabilityAccount|Sustainability\npbiSustainabilityAccountCategory|Sustainability\npbiSustainabilityGoal|Sustainability\npbiSustainabilityLedgerEntry|Sustainability\npbiSustainabilitySubAccountCategory|Sustainability\nplanningComponentLine|Manufacturing\nprodItemLedgerEntry|Manufacturing, Inventory\nprodOrderCapacityNeed|Manufacturing\nprodOrderRoutingLine|Manufacturing\npurchaseCreditMemoLine|Purchasing\npurchaseInvoiceLine|Purchasing\npurchaseItemBudgetEntry|Purchasing\npurchaseLine|Purchasing\npurchaseValueEntry|Purchasing\nrequisitionLine|Purchasing\nresource|Sales, Projects\nreturnReasonCode|Sales, Purchasing\nrouting|Manufacturing\nroutingLink|Manufacturing\nsalesCreditLine|Sales\nsalesCrProjectLedgerEntry|Sales, Projects\nsalesCycleStage|Sales\nsalesInvoiceLine|Sales\nsalesInvoiceProjectLedgerEntry|Sales, Projects\nsalesItemBudgetEntry|Sales\nsalesLine|Sales\nsalespersonPurchaser|Finance, Sales, Purchasing, Projects\nsalesValueEntry|Sales\ntoBinWarehouseJournalLine|Inventory\ntransferLine|Inventory\nvendor|Finance, Purchasing\nvendorLedgerEntry|Finance\nwarehouseActivityLine|Inventory\nwarehouseEntry|Inventory\nworkCenter|Manufacturing\nworkCenterGroup|Manufacturing\nworkingDay|Manufacturing\nzone|Inventory\n## Endpoint pattern\nAnalytics API endpoints use the `microsoft/analytics` publisher and the v1.0 version:\n```http\nGET https://api.businesscentral.dynamics.com/v2.0/{environmentName}/api/microsoft/analytics/v1.0/companies({companyId})/{entitySet}\n```\nFor example:\n```http\nGET https://api.businesscentral.dynamics.com/v2.0/{environmentName}/api/microsoft/analytics/v1.0/companies({companyId})/accountCategories\n```\n## Authentication and authorization\nCalls to the Analytics API require a Microsoft Entra access token and permissions to the target company data.\n## Next steps\n Explore entity definitions under the Analytics API resource reference.\n Use the corresponding GET operation pages for request and response examples.\n Connect Power BI to these endpoints as data sources for analytics apps.\n## Related information\nTips for working with APIs<../developer/devenv-connect-apps-tips>\nEnabling the APIs for Dynamics 365 Business Central<../api-reference/v2.0/enabling-apis-for-dynamics-nav>\n../webservices/api-endpoint-structure\nBusiness Central API (v2.0)<../api-reference/v2.0>\nWork with Power BI in Business Central</across-working-with-powerbi>\nFinance KPI overview</finance-powerbi-kpis>\nPower BI Sales app semantic model</sales-powerbi-app-semantic-model>\nKPIs and measures in the Power BI Sales app</sales-powerbi-sales-kpis>"}