curl --request GET \
--url https://omnicommerce.sg/api/v1/analytics/reports \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://omnicommerce.sg/api/v1/analytics/reports', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://omnicommerce.sg/api/v1/analytics/reports"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"ok": true,
"apiVersion": "developer_v1",
"operationId": "<string>",
"status": "accepted",
"warnings": [
"<string>"
],
"recommendations": [
"<string>"
],
"links": {},
"data": {
"filters": {
"from": "<string>",
"to": "<string>",
"marketplace": "<string>",
"country": "<string>",
"store": "<string>",
"currency": "<string>",
"timeZone": "<string>"
},
"kpis": [
{
"id": "<string>",
"label": "<string>",
"value": 123,
"previous": 123,
"unit": "currency",
"changePercent": 123
}
],
"topProducts": [
{
"productId": "<string>",
"variantId": "<string>",
"name": "<string>",
"variantName": "<string>",
"sku": "<string>",
"thumbnailUrl": "<string>",
"totalRevenue": 123
}
],
"marketplaceBreakdown": [
{
"platform": "<string>",
"country": "<string>",
"revenue": 123,
"orders": 0,
"share": 123
}
],
"alerts": [
{
"id": "<string>",
"title": "<string>",
"description": "<string>",
"tone": "warning"
}
],
"settlements": {
"ordersCount": 0,
"withFinanceCount": 0,
"missingFinanceCount": 0,
"grossSales": 123,
"netSettlement": 123,
"platformFees": 123,
"fulfillmentFees": 123
},
"dataQuality": {
"generatedAt": "<string>",
"lastOrderUpdatedAt": "<string>",
"lastFinanceEventAt": "<string>",
"financeCoverage": 123,
"costCoverage": 123,
"profitComplete": true
}
},
"jobId": "<string>",
"productId": "<string>"
}Get Business Report
The management summary: headline KPIs, top products, sales by marketplace, alerts, settlement totals, and data quality. Matches the Business Reports page. Requires analytics:read.
Amounts are in data.filters.currency. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
curl --request GET \
--url https://omnicommerce.sg/api/v1/analytics/reports \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://omnicommerce.sg/api/v1/analytics/reports', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://omnicommerce.sg/api/v1/analytics/reports"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"ok": true,
"apiVersion": "developer_v1",
"operationId": "<string>",
"status": "accepted",
"warnings": [
"<string>"
],
"recommendations": [
"<string>"
],
"links": {},
"data": {
"filters": {
"from": "<string>",
"to": "<string>",
"marketplace": "<string>",
"country": "<string>",
"store": "<string>",
"currency": "<string>",
"timeZone": "<string>"
},
"kpis": [
{
"id": "<string>",
"label": "<string>",
"value": 123,
"previous": 123,
"unit": "currency",
"changePercent": 123
}
],
"topProducts": [
{
"productId": "<string>",
"variantId": "<string>",
"name": "<string>",
"variantName": "<string>",
"sku": "<string>",
"thumbnailUrl": "<string>",
"totalRevenue": 123
}
],
"marketplaceBreakdown": [
{
"platform": "<string>",
"country": "<string>",
"revenue": 123,
"orders": 0,
"share": 123
}
],
"alerts": [
{
"id": "<string>",
"title": "<string>",
"description": "<string>",
"tone": "warning"
}
],
"settlements": {
"ordersCount": 0,
"withFinanceCount": 0,
"missingFinanceCount": 0,
"grossSales": 123,
"netSettlement": 123,
"platformFees": 123,
"fulfillmentFees": 123
},
"dataQuality": {
"generatedAt": "<string>",
"lastOrderUpdatedAt": "<string>",
"lastFinanceEventAt": "<string>",
"financeCoverage": 123,
"costCoverage": 123,
"profitComplete": true
}
},
"jobId": "<string>",
"productId": "<string>"
}Authorizations
Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.
Query Parameters
Required for session auth. API keys already belong to one organization.
160First day of the range (YYYY-MM-DD). Defaults to 29 days before to.
^\d{4}-\d{2}-\d{2}$Last day of the range, inclusive (YYYY-MM-DD). Defaults to today.
^\d{4}-\d{2}-\d{2}$IANA time zone that defines each day, for example Asia/Kuala_Lumpur. Defaults to Asia/Singapore.
80Comma-separated marketplaces, for example shopee,lazada.
200Comma-separated countries. One country selects its currency.
200Comma-separated store (account) ids from GET /api/v1/marketplaces/connected.
1000ISO currency. Only orders in this currency are counted; amounts are not converted. Defaults to the single country's currency, otherwise SGD.
3Response
Get Business Report
"developer_v1"accepted, completed, failed Show child attributes
Show child attributes
Show child attributes
Show child attributes