Set a client's tier
Put a client organization on a pre-agreed sub-org tier, or take it off one.
Name the client with the Nxos-On-Behalf-Of header. Unlike other cross-org
endpoints, holding an LOA is not sufficient here: you may only set the tier
of an organization you created via POST /v1/organizations. This stops
a customer repricing itself while acting on its own behalf.
You can price a client from the moment you create them — verification does not need to have completed.
Assign a tier at any time after the client is created — pricing takes effect on their next quote, and on the commission you earn from their next trade. Trades already executed are unaffected.
Pass subOrgTierKey: null to remove the tier and return the client to default
pricing. List the tiers you may assign with GET /v1/sub-org-tiers.
Headers
Bearer token. Format: Bearer <api_key>
Body
Request body for PUT /v1/organizations/sub-org-tier.
Key of the tier to assign, from GET /v1/sub-org-tiers. Pass null (or
omit) to remove the organization's tier, dropping it back to default
pricing.
Response
The request has succeeded.
Result of setting or clearing an organization's sub-org tier.