Start Customer Application

POST

https://demo-d.tradovateapi.com/v1/customerApplication/startcustomerapplication

POST

/v1/customerApplication/startcustomerapplication

1 const url = 'https://demo-d.tradovateapi.com/v1/customerApplication/startcustomerapplication';
2 const options = {
3   method: 'POST',
4   headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5   body: '{"accountType":"Customer","legalStatus":"Corporation"}'
6 };
7 
8 try {
9   const response = await fetch(url, options);
10   const data = await response.json();
11   console.log(data);
12 } catch (error) {
13   console.error(error);
14 }

200Successful

1 {
2   "errorText": "string",
3   "customerApplication": {
4     "userId": 1,
5     "accountType": "Customer",
6     "legalStatus": "Corporation",
7     "startDate": "2024-01-15T09:30:00Z",
8     "applicationStatus": "ApprovedApplication",
9     "archived": true,
10     "id": 1,
11     "rejectReason": "AMLWatchlist",
12     "additionalNotes": "string",
13     "accountId": 1,
14     "rejectDate": "2024-01-15T09:30:00Z",
15     "clearingHouseId": 1,
16     "autoApprovalType": "AutoApproved"
17   }
18 }

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

accountTypeenumRequired

Customer, Giveup, House, Omnibus, Wash

legalStatusenumRequired

Corporation, GP, IRA, Individual, Joint, LLC, LLP, LP, PTR, Trust

clearingHouseIdlongOptional

userIdlongOptional

Response

CustomerApplicationResponse

errorTextstringOptional<=8192 characters

Non-empty if the request failed

customerApplicationobjectOptional