Reporting Manager API · commissions
The signed-in rep's own commission over a window of days
GET /commissions/mine
The signed-in rep's own commission over a window of days (from/to, inclusive; this month to date when omitted): what they earned, what refunds clawed back, the net owed and the commissionable revenue, all in the home currency, with every line behind it.
Every rep's commission is the commission entity of the report library, for commissions:read.
Access
Requires a signed-in session: a rep reads only their own commission: the rows are the session's own user, never a parameter
How scopes come from roles: Scopes and roles. Getting a token: Authentication and app tokens.
AI agent tool
No agent tool. A rep's own commission is theirs to read in the admin; an agent reads every rep's through the report library's commission entity (reporting_run_report), which commissions:read opens.
Connecting an agent: AI agents.
Example
curl -X GET 'https://reporting.getmanifold.io/commissions/mine?from=2026-10-01&to=2026-10-31' \
-H "Authorization: Bearer $MANIFOLD_TOKEN"const response = await fetch("https://reporting.getmanifold.io/commissions/mine?from=2026-10-01&to=2026-10-31", {
method: "GET",
headers: { Authorization: `Bearer ${process.env.MANIFOLD_TOKEN}` },
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const answer = await response.json();{
"repId": "usr_019e5a10-51b0-7a42-8c1d-0e9f3a6b2c71",
"from": "2026-10-01",
"to": "2026-10-31",
"earnedCents": 720,
"clawbackCents": -120,
"commissionCents": 600,
"basisCents": 12000,
"lines": [
{
"day": "2026-10-12",
"orderId": "ord_01a158e0-8b90-7ca1-9db2-1b2c3d4e5f60",
"lineId": "lin_01a158e0-8b90-7ca1-9db2-2c3d4e5f6071",
"sku": "MUG-BLUE",
"kind": "earned",
"rateBps": 500,
"basisCents": 14400,
"commissionCents": 720
},
{
"day": "2026-10-20",
"orderId": "ord_01a158e0-8b90-7ca1-9db2-1b2c3d4e5f60",
"lineId": "lin_01a158e0-8b90-7ca1-9db2-2c3d4e5f6071",
"sku": "MUG-BLUE",
"kind": "clawback",
"rateBps": 500,
"basisCents": -2400,
"commissionCents": -120
}
]
}The panel writes this call in other languages. It does not send it: Manifold's APIs do not take calls from a web
page on another site, so run the call from your own code or terminal. The whole API as OpenAPI: reporting-manager.openapi.json. Base URL https://reporting.getmanifold.io.
Errors
Every refusal is a status and a JSON body whose _tag names it. A refused call changes nothing.
401
| Refusal | What it means | What to do |
|---|---|---|
Unauthorized reason | The token is missing, expired or not one Manifold issued. | Get a fresh token and send the call again. |
TokenAlreadyUsed tokenId | A single-use app token was already spent. | Mint a new token for this call. |
402
| Refusal | What it means | What to do |
|---|---|---|
SubscriptionRequired status | The organization's subscription has lapsed, so writes are refused. | An owner settles billing. Reads still work meanwhile. |
403
| Refusal | What it means | What to do |
|---|---|---|
TenantRequired userId | The token names no organization. | Choose the organization, then get a new token. |
ScopeRequired required | The token's roles do not grant the scope this call needs. | Ask an owner or admin for a role that grants it. |
409
| Refusal | What it means | What to do |
|---|---|---|
MirroredFromSource source | This area is fed by your source system until the organization goes live. | Make the change in the source system, or go live first. |
503
| Refusal | What it means | What to do |
|---|---|---|
RequestLogUnavailable tokenId, reason | The service could not record the request, so it did nothing. | Try again shortly. |
How refusals work everywhere: Errors.