Commerce

List authorized Business Central connections

GET
/v1/protocol/commerce/data/sources

Default off; requires COMMERCE_MCP_OAUTH_DATA_ACCESS_ENABLED and COMMERCE_MCP_BUSINESS_CENTRAL_ENABLED, a live Accounts Microsoft purchase, current membership and signed v2 or v3 consent. An opaque connection identifies a separately verified company within the purchaser tenant extracted by Accounts. Reads are bounded to eight seconds and 100 documents, return no connector credentials, and cannot execute an ERP action. Connected v3 source discovery reports BC history unavailable; its historical tools cover only Walmart and Adobe. Requires erp:read.

Authorization

CommerceAccountsOAuth
AuthorizationBearer <token>

Opaque Accounts-issued Commerce OAuth access credential with resource-bound current purchase. Legacy base3, signed v2 ERP/history and fresh signed v3 nine-scope connected grants retain distinct route profiles. Refresh credentials never authenticate. Per-operation connection, current role, proof, quota and confirmation checks remain mandatory.

In: header

Query Parameters

org_id*string
Formatuuid

Response Body

application/json

curl -X GET "https://example.com/v1/protocol/commerce/data/sources?org_id=497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "version": "commerce-erp-sources-v1",  "org_id": "a40f5d1f-d889-42e9-94ea-b9b33585fc6b",  "connections": [    {      "connection_id": "d3547de1-d1f2-4344-b4c2-17169b7526f9",      "platform": "business-central",      "display_name": "string",      "environment_name": "string",      "revision": -9007199254740991,      "views": [        "current_orders",        "posted_invoices"      ],      "history_available": true    }  ],  "coverage": {    "connection_limit": 20,    "truncated": true  },  "execution_available": false}