B2BROKER
B2CORE
B2CORE IB
B2TRADER
B2CONNECT
B2TRANSLATE
B2BROKERGet Dashboard Top Sub-IBs
The partner's direct referrals that are IBs themselves, ranked by the rebate the partner earned through their whole downline in the window. Only sub-IBs with a positive rebate are listed. As in `GET /partner/dashboard/top-clients`, the rows are current direct referrals and their current downlines.
Authorization
appToken readApp access token issued by POST /tokens (client credentials). Full-access Apps hold the read and write scopes, read-only Apps hold read only. Send it as Authorization: Bearer <token>.
In: header
Scope: read
Query Parameters
Identifier of the partner user (the IB record) whose dashboard is requested
uuidStart of the window (inclusive), RFC 3339 with an offset. Encode + as %2B: a raw + in a query string reads as a space. Any window length is accepted; long windows take longer.
date-timeEnd of the window (exclusive), RFC 3339 with an offset; must be after startTime. Operations at exactly this time are not counted; to include a whole day, pass the next day's 00:00.
date-timeMaximum number of ranked rows to return
1 <= value <= 10050When true, every metric also carries its change versus the previous equal-length window [startTime − (endTime − startTime), startTime). When false, absoluteChange and relativeChange are null.
falseResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/partner/dashboard/top-sub-ibs?userId=497f6eca-6276-4993-bfeb-53cbbbba6f08&startTime=2026-10-01T00%3A00%3A00%2B02%3A00&endTime=2026-11-01T00%3A00%3A00%2B01%3A00"{ "report": { "isMasked": true, "data": [ { "clientExternalId": "20411", "name": "Anna Ivanova", "rebate": { "currency": "EUR", "actualValue": "1200.00", "absoluteChange": "150.00", "relativeChange": "14.29" } } ] }}{ "error": { "message": "validation failed", "code": "validation_error", "details": [ { "field": "startTime", "issue": "the window has more than 5000 hour buckets" } ] }}{ "message": "string", "code": "string", "errors": { "property1": [ "string" ], "property2": [ "string" ] }, "details": [ { "field": "string", "issue": "string" } ]}{ "error": { "message": "partner user not found", "code": "not_found" }}{ "message": "string", "code": "string", "errors": { "property1": [ "string" ], "property2": [ "string" ] }, "details": [ { "field": "string", "issue": "string" } ]}{ "message": "string", "code": "string", "errors": { "property1": [ "string" ], "property2": [ "string" ] }, "details": [ { "field": "string", "issue": "string" } ]}{ "error": { "message": "the report took too long to build", "code": "gateway_timeout" }}