Get Partner Subaccount Request Status

Check the status of a subaccount request.

Available to: Organization administrators

Environments: Production

Rate Limit: Although this endpoint does not have a rate limit, you should implement appropriate polling intervals (e.g., every 30-60 seconds) to avoid unnecessary load.

Poll this endpoint to track the progress of a subaccount request through the approval workflow. The request progresses through various statuses as it is reviewed by internal operations teams.

Warning: This endpoint returns HTTP 200 for successes and business errors. Always check the errorText field in the response body to determine whether the request succeeded or failed.

subAccountRequestId

For subAccountRequestId, use the requestId returned from createpartnersubaccountrequest.

Status Progression

Requests typically progress through statuses in this order: Preapproved → InReview → InAMLReview (if applicable) → Approved or Denied

Status changes may not be immediate.
InAMLReview means the request is being reviewed by the Anti-Money Laundering (AML) team.
If the subaccount request is Denied, check the message field for the reason.

Common Failure Scenarios

Invalid or non-existent subAccountRequestId
subAccountRequestId belongs to a different organization
Non-admin user attempting to call the endpoint

### Check the status of a subaccount request. **Available to:** Organization administrators **Environments:** Production **Rate Limit:** Although this endpoint does not have a rate limit, you should implement appropriate polling intervals (e.g., every 30-60 seconds) to avoid unnecessary load. Poll this endpoint to track the progress of a subaccount request through the approval workflow. The request progresses through various statuses as it is reviewed by internal operations teams. <Warning>**Warning:** This endpoint returns **HTTP 200** for successes **and** business errors. Always check the `errorText` field in the response body to determine whether the request succeeded or failed.</Warning> **subAccountRequestId** For `subAccountRequestId`, use the `requestId` returned from `createpartnersubaccountrequest`. **Status Progression** Requests typically progress through statuses in this order: `Preapproved` → `InReview` → `InAMLReview` (if applicable) → `Approved` or `Denied` - Status changes may not be immediate. - `InAMLReview` means the request is being reviewed by the Anti-Money Laundering (AML) team. - If the subaccount request is `Denied`, check the `message` field for the reason. **Common Failure Scenarios** - Invalid or non-existent `subAccountRequestId` - `subAccountRequestId` belongs to a different organization - Non-admin user attempting to call the endpoint

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

subAccountRequestIdlongRequired

The requestId value returned from createpartnersubaccountrequest.

Response

GetPartnerSubaccountRequestStatusResponse

requestIdlong or null

The request ID that was queried.

statusenum or null

Current status of the subaccount request.

messagestring or null

Human-readable message providing context about the current status. Always present in successful responses.

errorTextstring or null

Error message if the request failed (access control errors).

Check the status of a subaccount request.

Available to: Organization administrators

Environments: Production

Rate Limit: Although this endpoint does not have a rate limit, you should implement appropriate polling intervals (e.g., every 30-60 seconds) to avoid unnecessary load.

Poll this endpoint to track the progress of a subaccount request through the approval workflow. The request progresses through various statuses as it is reviewed by internal operations teams.

Warning: This endpoint returns HTTP 200 for successes and business errors. Always check the errorText field in the response body to determine whether the request succeeded or failed.

subAccountRequestId

For subAccountRequestId, use the requestId returned from createpartnersubaccountrequest.

Status Progression

Requests typically progress through statuses in this order: Preapproved → InReview → InAMLReview (if applicable) → Approved or Denied

Status changes may not be immediate.
InAMLReview means the request is being reviewed by the Anti-Money Laundering (AML) team.
If the subaccount request is Denied, check the message field for the reason.

Common Failure Scenarios

Invalid or non-existent subAccountRequestId
subAccountRequestId belongs to a different organization
Non-admin user attempting to call the endpoint

1	curl -X POST https://demo.tradovateapi.com/v1/customerApplication/getpartnersubaccountrequeststatus \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"subAccountRequestId": 1
6	}'

1	{
2	"requestId": 1,
3	"status": "Pending",
4	"message": "string",
5	"errorText": "string"
6	}