Returns the Sales By User leaderboard: one row per user (sales rep) with their leaderboard rank, order count, pre-tax sales, and total sales over the reported date range. Rows are always ranked by total sales and returned in that order, with the top seller at rank 1 — this ordering is fixed and cannot be changed by the caller.

This is a read-only aggregate of the orders already in your account; it creates nothing and changes no inventory, compliance, or order state. Each order is attributed to the user set as its sales rep, and the money columns are net of returns — a return lowers that rep's pre-tax and total sales. Both money columns reflect the same set of orders; total_sales includes tax while sales_pre_tax excludes it.

Scope of what is counted: • Date range — orders are included by their order date. When order_datetime is omitted, the report covers the last 30 days (from the start of the day 30 days ago through the end of today), resolved in the account's time zone. • Status — canceled orders are excluded by default. To count them, pass CANCELED in the status filter; passing status at all replaces the default set entirely, so list every status you want counted. • Users — every sales rep with at least one qualifying order appears; deactivated users are omitted. Use user_ids to restrict the leaderboard to specific reps.

Response values mirror the report's CSV export with numeric cells returned as strings, so leaderboard_rank, order_count, and the two money columns come back as strings (currency and comma formatting stripped), matching the rest of the API. Report-level context — the resolved human-readable date range and the column definitions — is returned under meta.

Each row also carries user_id, the ID of the user it ranks, right after the user column, so a row can be followed to the user endpoints without a name lookup. The CSV export leaves this ID column out.

Requires the "view the sales by user report" permission on the API key's user.