Reporting

POS Hub exposes one reporting API for both native POS Hub reports and reports generated by connected applications. API consumers always create, poll, and download reports through POS Hub endpoints; applications only participate when POS Hub delegates a report request.

Report Sources

POS Hub reports are generated from POS Hub order, delivery, and sales data.
Application reports are generated by a reporting-enabled marketplace application and uploaded back into POS Hub managed storage.

The public reportType contract uses POS Hub canonical names. Provider-specific report names, such as Uber Eats report_type values, are adapter implementation details and are not accepted by the public API.

Native POS Hub Report Flow

Application Report Flow

Requesting Reports

Use reports.write to create or cancel reports and reports.read to list, read, and download reports.

Create reports through the account or reseller scope:

json

{
  "reportType": "ORDER_DETAIL",
  "startDate": "2026-05-01",
  "endDate": "2026-05-07",
  "timezone": "Europe/London"
}

For application reports, include the reporting-enabled applicationId and exactly one locationIds entry:

json

{
  "reportType": "ORDERS_AND_ITEMS",
  "applicationId": "app_123",
  "locationIds": ["loc_123"],
  "startDate": "2026-05-01",
  "endDate": "2026-05-07",
  "timezone": "Europe/London"
}

Canonical Report Types

POS Hub report types are static and documented in the API schema. Applications advertise support by configuring canonical supportedReportTypes on their application record.

Uber Eats maps canonical POS Hub types to upstream report names internally:

POS Hub report type	Uber Eats upstream report type
`PAYMENT_DETAIL`	`PAYMENT_DETAILS_REPORT`
`ORDER_ERROR_MENU_ITEM`	`ORDER_ERRORS_MENU_ITEM_REPORT`
`ORDER_ERROR_TRANSACTION`	`ORDER_ERRORS_TRANSACTION_REPORT`
`ORDER_HISTORY`	`ORDER_HISTORY_REPORT`
`DOWNTIME`	`DOWNTIME_REPORT`
`CUSTOMER_AND_DELIVERY_FEEDBACK`	`CUSTOMER_AND_DELIVERY_FEEDBACK_REPORT`
`MENU_ITEM_FEEDBACK`	`MENU_ITEM_FEEDBACK_REPORT`
`BILLING_DETAIL`	`BILLING_DETAILS_REPORT`
`ORDERS_AND_ITEMS`	`ORDERS_AND_ITEMS_REPORT`
`FINANCE_SUMMARY`	`FINANCE_SUMMARY_REPORT`

Application Completion

Reporting applications complete delegated reports by requesting a signed upload URL, uploading the artifact, then patching the report with SUCCEEDED and artifact metadata. End users cannot call artifact upload or completion endpoints.

Reporting ​

Report Sources ​

Native POS Hub Report Flow ​

Application Report Flow ​

Requesting Reports ​

Canonical Report Types ​

Application Completion ​