SEI Developer Portal | Subscription Initiation

Subscription Initiation

POST

/trade/initiation

Create a transaction for an investor with either just the investor details or investor and advisor details or just the investment advisor details. Product information, request type and one of the investor/advisor details are mandatory to create a successful transaction.

Prod:

https://api.seic.com/v1/trade/initiation

Header Parameters

Name	Description	Data Type
Authorization	access_token value obtained from the Token endpoint.This is passed as "Bearer access_token "	string
AppKey	This is the Consumer Key provided during the App Registration process and is used to identify the user's application.	string
Content-Type	This is the content type of the payload being passed. Valid value is application/json.	string

Body Parameters

Name	Description	Data Type	Required
InitiationRequest		object

HTTP Responses

Code

Description
201

Opportunities Created.
400

Bad request - The server cannot or will not process the request due to an inaccurate request submitted by the client application. Please resubmit the request after making the required corrections indicated in the error response. For more Info on SEI Error Standards please refer to the API Standards FAQ under Support.
401

Unauthorized - Invalid authentication details have been provided. Also useful to trigger an authorization pop up if the API is used from a browser.
403

Forbidden-The SEI Server understood the request but refuses to fulfill it.
404

Not Found- The requested resource or the underlying resource does not exist. Please resubmit the request after making the required corrections
500

Internal Server Error - The SEI server was unable to fulfill the request due to an unknown condition. Please contact SEI for support. For More Info please refer to the "Response & Errors" FAQ under support.

TEST ENDPOINT

Authorization	access_token value obtained from the Token endpoint.This is passed as "Bearer access_token "
AppKey	This is the Consumer Key provided during the App Registration process and is used to identify the user's application.
Content-Type	This is the content type of the payload being passed. Valid value is application/json.

InitiationRequest

Request Body

Payload format required to create initiation orders.

HTTP Basic

Set...

OAuth 2.0

Set...

API Key

Set...

Working...

Subscription Initiation

POST

/trade/initiation

Prod:

https://api.seic.com/v1/trade/initiation

Header Parameters

Name	Description	Data Type
Authorization	access_token value obtained from the Token endpoint.This is passed as "Bearer access_token "	string
AppKey	This is the Consumer Key provided during the App Registration process and is used to identify the user's application.	string
Content-Type	This is the content type of the payload being passed. Valid value is application/json.	string

Body Parameters

Name	Description	Data Type	Required
InitiationRequest		object

HTTP Responses

Code

Description
201

Opportunities Created.
400

Bad request - The server cannot or will not process the request due to an inaccurate request submitted by the client application. Please resubmit the request after making the required corrections indicated in the error response. For more Info on SEI Error Standards please refer to the API Standards FAQ under Support.
401

Unauthorized - Invalid authentication details have been provided. Also useful to trigger an authorization pop up if the API is used from a browser.
403

Forbidden-The SEI Server understood the request but refuses to fulfill it.
404

Not Found- The requested resource or the underlying resource does not exist. Please resubmit the request after making the required corrections
500

Internal Server Error - The SEI server was unable to fulfill the request due to an unknown condition. Please contact SEI for support. For More Info please refer to the "Response & Errors" FAQ under support.

TEST ENDPOINT

Authorization	access_token value obtained from the Token endpoint.This is passed as "Bearer access_token "
AppKey	This is the Consumer Key provided during the App Registration process and is used to identify the user's application.
Content-Type	This is the content type of the payload being passed. Valid value is application/json.

InitiationRequest

Request Body

Payload format required to create initiation orders.

HTTP Basic

Set...

OAuth 2.0

Set...

API Key

Set...

Working...

Test: https://test.api.seic.com/v1/trade/initiation

TLS*: https://mtls.api.seic.com/v1/trade/initiation

*The TLS endpoint is only used if Server Based Application was selected during the App Registration process.

STEP 2

Pass the oAuth Token and the App key to invoke this endpoint for a particular application.

Subscription Initiation

POST

/trade/initiation

Prod:

https://api.seic.com/v1/trade/initiation

Header Parameters

Name	Description	Data Type
Authorization	access_token value obtained from the Token endpoint.This is passed as "Bearer access_token "	string
AppKey	This is the Consumer Key provided during the App Registration process and is used to identify the user's application.	string
Content-Type	This is the content type of the payload being passed. Valid value is application/json.	string

Body Parameters

Name	Description	Data Type	Required
InitiationRequest		object

HTTP Responses

Code

Description
201

Opportunities Created.
400

Bad request - The server cannot or will not process the request due to an inaccurate request submitted by the client application. Please resubmit the request after making the required corrections indicated in the error response. For more Info on SEI Error Standards please refer to the API Standards FAQ under Support.
401

Unauthorized - Invalid authentication details have been provided. Also useful to trigger an authorization pop up if the API is used from a browser.
403

Forbidden-The SEI Server understood the request but refuses to fulfill it.
404

Not Found- The requested resource or the underlying resource does not exist. Please resubmit the request after making the required corrections
500

Internal Server Error - The SEI server was unable to fulfill the request due to an unknown condition. Please contact SEI for support. For More Info please refer to the "Response & Errors" FAQ under support.

TEST ENDPOINT

Authorization	access_token value obtained from the Token endpoint.This is passed as "Bearer access_token "
AppKey	This is the Consumer Key provided during the App Registration process and is used to identify the user's application.
Content-Type	This is the content type of the payload being passed. Valid value is application/json.

InitiationRequest

Request Body

Payload format required to create initiation orders.

HTTP Basic

Set...

OAuth 2.0

Set...

API Key

Set...

Working...

SAMPLE REQUEST

#SCENARIO 1: DIRECT INVESTOR
curl -X POST \
 https://api.seic.com/v1/trade/initiation \
  -H 'appkey: gsedgaerhDSHGRSH\
  -H 'authorization: Bearer ADsgdnnkjnfdIKJN; \
  -H 'cache-control: no-cache; \
  -H 'content-type: application/json; \
  -d {
  "data": [
    {
        "requestType": "New Subscription",
        "channel": "Direct",
        "opportunityGroupId": "string",
        "externalOrderId": "WWC_{{$timestamp}}",
        "firm": "string",
        "team": "string",
        "group": "string",
        "tradeDate": "2018-09-25T00:00:00Z",
        "orderDate": "2018-09-25T00:00:00Z",
        "eSign": true,
      "products": [
        {
          "productName": "Worldwide Capital Event Driven Fund, LP",
          "classIds": [
            "string"
          ],
          "amlRepLetter": true,
          "funds": [
            {
              "externalId": "string",
              "amount": 0,
              "currency": "string"
            }
          ]
        }
      ],     
     "investor": {
        "name": "John Doe Personal Trust",
        "externalId": "string",
        "subscriberType": "string",
        "accountNumber": "string",
        "contact": {
          "fullName": "string",
          "firstName": "string",
          "lastName": "string",
          "email": "jdoe@gmail.com",
          "externalId": "string"
        },
        "label": {
          "city": "string",
          "stateCode": "string",
          "postalCode": "string",
          "countryIsoCode": "string"
          "address1": "string",
          "address2": "string",
          "zip": "string"
        }
      }
    }
  ]
}

#SCENARIO 2: INVESTMENT ADVISOR
curl -X POST \
 https://api.seic.com/v1/trade/initiation \
  -H 'appkey: gsedgaerhDSHGRSH\
  -H 'authorization: Bearer ADsgdnnkjnfdIKJN; \
  -H 'cache-control: no-cache; \
  -H 'content-type: application/json; \
  -d {
  {
  "data": [
   {
        "requestType": "New Subscription",
        "channel": "Direct",
        "opportunityGroupId": "string",
        "externalOrderId": "WWC_{{$timestamp}}",
        "firm": "string",
        "team": "string",
        "group": "string",
        "tradeDate": "2018-09-25T00:00:00Z",
        "orderDate": "2018-09-25T00:00:00Z",
        "eSign": true,
      "products": [
        {
          "productName": "Worldwide Capital Event Driven Fund, LP",
          "classIds": [
            "string"
          ],
          "amlRepLetter": true,
          "funds": [
            {
              "externalId": "string",
              "amount": 0,
              "currency": "string"
            }
          ]
        }
      ],     
      "advisor": {
        "externalId": "string",
        "division": "string",
        "region": "string",
        "contact": {
          "fullName": "Test Advisor",
          "firstName": "string",
          "lastName": "string",
          "email": "testadvisor@gmail.com",
          "externalId": "string"
        },
        "label": {
          "city": "string",
          "stateCode": "string",
          "postalCode": "string",
          "countryIsoCode": "string"
          "address1": "string",
          "address2": "string",
          "zip": "string"
        }
      }
    }
  ]
}

#SCENARIO 3: INVESTOR AND ADVISOR
curl -X POST \
 https://api.seic.com/v1/trade/initiation \
  -H 'appkey: gsedgaerhDSHGRSH\
  -H 'authorization: Bearer ADsgdnnkjnfdIKJN; \
  -H 'cache-control: no-cache; \
  -H 'content-type: application/json; \
  -d {
  "data": [
   {
        "requestType": "New Subscription",
        "channel": "Direct",
        "opportunityGroupId": "string",
        "externalOrderId": "WWC_{{$timestamp}}",
        "firm": "string",
        "team": "string",
        "group": "string",
        "tradeDate": "2018-09-25T00:00:00Z",
        "orderDate": "2018-09-25T00:00:00Z",
        "eSign": true,
      "products": [
        {
          "productName": "Worldwide Capital Event Driven Fund, LP",
          "classIds": [
            "string"
          ],
          "amlRepLetter": true,
          "funds": [
            {
              "externalId": "string",
              "amount": 0,
              "currency": "string"
            }
          ]
        }
      ],    
      "advisor": {
        "externalId": "string",
        "division": "string",
        "region": "string",
        "contact": {
          "fullName": "Test Advisor",
          "firstName": "string",
          "lastName": "string",
          "email": "testadvisor@gmail.com",
          "externalId": "string"
        },
        "label": {
          "city": "string",
          "stateCode": "string",
          "postalCode": "string",
          "countryIsoCode": "string"
          "address1": "string",
          "address2": "string",
          "zip": "string"
        }
      },
      "investor": {
        "name": "John Doe",
        "externalId": "string",
        "subscriberType": "string",
        "accountNumber": "string",
        "contact": {
          "fullName": "John Doe",
          "firstName": "string",
          "lastName": "string",
          "email": "jdoe@gmail",
          "externalId": "string"
        },
        "label": {
          "city": "string",
          "stateCode": "string",
          "postalCode": "string",
          "countryIsoCode": "string"
          "address1": "string",
          "address2": "string",
          "zip": "string"
        }
      },
        }
      }
    }
  ]
}

#4 SCENARIO 4: FULL PAYLOAD
curl -X POST \
 https://api.seic.com/v1/trade/initiation \
  -H 'appkey: bAlFetvKS2D10zabqlYMATTlLlGbZFoN\
  -H 'authorization: Bearer b923809d37d0a21b7e1234f45cee528f5aec71224tf4b10e' \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -d '{
  "data": [
    {
      "requestType": "string",
      "channel": "string",
      "opportunityGroupId": "string",
      "externalOrderId": "string",
      "firm": "string",
      "team": "string",
      "group": "string",
      "tradeDate": "2020-11-03T00:06:43.772Z",
      "orderDate": "2020-11-03T00:06:43.772Z",
      "eSign": true,
      "products": [
        {
          "productName": "string",
          "classIds": [
            "string"
          ],
          "amlRepLetter": true,
          "funds": [
            {
              "externalId": "string",
              "amount": 0,
              "currency": "string"
            }
          ]
        }
      ],
      "advisor": {
        "externalId": "string",
        "division": "string",
        "region": "string",
        "contact": {
          "fullName": "string",
          "firstName": "string",
          "lastName": "string",
          "email": "string",
          "externalId": "string"
        },
        "label": {
          "city": "string",
          "stateCode": "string",
          "postalCode": "string",
          "countryIsoCode": "string",
          "address1": "string",
          "address2": "string",
          "zip": "string"
        }
      },
      "investor": {
        "name": "string",
        "externalId": "string",
        "subscriberType": "string",
        "accountNumber": "string",
        "contact": {
          "fullName": "string",
          "firstName": "string",
          "lastName": "string",
          "email": "string",
          "externalId": "string"
        },
        "label": {
          "city": "string",
          "stateCode": "string",
          "postalCode": "string",
          "countryIsoCode": "string",
          "address1": "string",
          "address2": "string",
          "zip": "string"
        }
      },
      "manager": {
        "fullName": "string",
        "firstName": "string",
        "lastName": "string",
        "email": "string",
        "externalId": "string"
      },
      "accessContacts": [
        {
          "access": "string",
          "contact": {
            "fullName": "string",
            "firstName": "string",
            "lastName": "string",
            "email": "string",
            "externalId": "string"
          },
          "label": {
            "countryIsoCode": "string"
          }
        }
      ],
      "formContacts": [
        {
          "contact": {
            "fullName": "string",
            "firstName": "string",
            "lastName": "string",
            "email": "string",
            "externalId": "string"
          },
          "label": {
            "countryIsoCode": "string"
          }
        }
      ],
      "custodians": [
        "string"
      ],
      "subForms": [
        {
          "id": "string"
        }
      ],
      "placementFee": [
        0
      ]
    }
  ]
}

REQUEST HEADER

Authorization: Bearer ADsgdnnkjnfdIKJN
AppKey: gsedgaerhDSHGRSH
Content-type: applciation/json

RESPONSE HEADER

Content-Type: application/json 
Status: 200 OK 
requesttrackingid: 67e1ff68-164f-03ad-0f2d-5cbbfda56ec9

SAMPLE RESPONSE

{
  "data": {
    "orders": [
      {
        "advisor": {
          "name": "string",
          "stateCode": "string"
        },
        "createdAt": "2020-11-03T15:00:51.576Z",
        "orderId": "string",
        "products": [
          {
            "name": "string",
            "trackingNumber": "string"
          }
        ],
        "accountNumber": "string",
        "opportunityGroupId": "string",
        "investorName": "string",
        "subform": [
          {
            "id": "string"
          }
        ],
        "placementFee": "string"
      }
    ],
    "faults": [
      {
        "code": "string",
        "message": "string",
        "userMessage": "string",
        "trackingId": "string",
        "transient": true
      }
    ]
  },
  "formatters": [
    {}
  ],
  "contentTypes": [
    {}
  ],
  "declaredType": "string",
  "statusCode": 200
}

MODEL

Operations

Name	Description	Data Type (L)
accountNumber	Code which uniquely identifies an individual or entity.	string
placementFees	Placement fees, only applicable for incoming transactions.	number(9)
faults.message	A developer specified message which accompanies the error.	string
faults.code	A semantic code which expresses the following {errorDomain}.{errorSubDomainOrResource}.{verb}.	string
faults.userMessage	A localized message based on the locale of the user. If unspecified, defaults to message.	string
faults.trackingId	A unique identifier which can be used to trace the logs.	string
faults.transient	Indicates if the error is temporary and the original request can be retried without any modifications.	string
content-type	Request content type. The valid values are application/xxx-form-url encoded.	string
orders	A Trade Initiation Request is called an order.	array
advisor	Field name stateCode	object
name	The business description for an entity in the context of the API, sometimes called a proper name. A name can apply to a Calendar, Financial Institution, Investor, Account, Advisor and various other entities.	string
stateCode	The two character code for US and Canadian states and provinces.	string
investorName	Investor full legal name as indicated on the subscription document.	string
createdAt	The date time the entity was created.	string
orderId	The Unique identifier of the order.	string
products	A collection of data points specific to an investment vehicles for which an investor is eligible to subscribe.	array
trackingNumber	A unique tracking number assigned to a specific request.	string

Subscription Initiation

POST

/trade/initiation

Prod:

https://api.seic.com/v1/trade/initiation

Header Parameters

Name	Description	Data Type
Authorization	access_token value obtained from the Token endpoint.This is passed as "Bearer access_token "	string
AppKey	This is the Consumer Key provided during the App Registration process and is used to identify the user's application.	string
Content-Type	This is the content type of the payload being passed. Valid value is application/json.	string

Body Parameters

Name	Description	Data Type	Required
InitiationRequest		object

HTTP Responses

Code

Description
201

Opportunities Created.
400

Bad request - The server cannot or will not process the request due to an inaccurate request submitted by the client application. Please resubmit the request after making the required corrections indicated in the error response. For more Info on SEI Error Standards please refer to the API Standards FAQ under Support.
401

Unauthorized - Invalid authentication details have been provided. Also useful to trigger an authorization pop up if the API is used from a browser.
403

Forbidden-The SEI Server understood the request but refuses to fulfill it.
404

Not Found- The requested resource or the underlying resource does not exist. Please resubmit the request after making the required corrections
500

Internal Server Error - The SEI server was unable to fulfill the request due to an unknown condition. Please contact SEI for support. For More Info please refer to the "Response & Errors" FAQ under support.

TEST ENDPOINT

Authorization	access_token value obtained from the Token endpoint.This is passed as "Bearer access_token "
AppKey	This is the Consumer Key provided during the App Registration process and is used to identify the user's application.
Content-Type	This is the content type of the payload being passed. Valid value is application/json.

InitiationRequest

Request Body

Payload format required to create initiation orders.

HTTP Basic

Set...

OAuth 2.0

Set...

API Key

Set...

Working...

Subscription Initiation

POST

/trade/initiation

Prod:

https://api.seic.com/v1/trade/initiation

Header Parameters

Name	Description	Data Type
Authorization	access_token value obtained from the Token endpoint.This is passed as "Bearer access_token "	string
AppKey	This is the Consumer Key provided during the App Registration process and is used to identify the user's application.	string
Content-Type	This is the content type of the payload being passed. Valid value is application/json.	string

Body Parameters

Name	Description	Data Type	Required
InitiationRequest		object

HTTP Responses

Code

Description
201

Opportunities Created.
400

Bad request - The server cannot or will not process the request due to an inaccurate request submitted by the client application. Please resubmit the request after making the required corrections indicated in the error response. For more Info on SEI Error Standards please refer to the API Standards FAQ under Support.
401

Unauthorized - Invalid authentication details have been provided. Also useful to trigger an authorization pop up if the API is used from a browser.
403

Forbidden-The SEI Server understood the request but refuses to fulfill it.
404

Not Found- The requested resource or the underlying resource does not exist. Please resubmit the request after making the required corrections
500

Internal Server Error - The SEI server was unable to fulfill the request due to an unknown condition. Please contact SEI for support. For More Info please refer to the "Response & Errors" FAQ under support.

TEST ENDPOINT

Authorization	access_token value obtained from the Token endpoint.This is passed as "Bearer access_token "
AppKey	This is the Consumer Key provided during the App Registration process and is used to identify the user's application.
Content-Type	This is the content type of the payload being passed. Valid value is application/json.

InitiationRequest

Request Body

Payload format required to create initiation orders.

HTTP Basic

Set...

OAuth 2.0

Set...

API Key

Set...

Working...

Test: https://test.api.seic.com/v1/trade/initiation

TLS*: https://mtls.api.seic.com/v1/trade/initiation

*The TLS endpoint is only used if Server Based Application was selected during the App Registration process.

STEP 1

oAuthToken

POST

STEP 2

Pass the oAuth Token and the App key to invoke this endpoint for a particular application.

Subscription Initiation

POST

/trade/initiation

Prod:

https://api.seic.com/v1/trade/initiation

Header Parameters

Name	Description	Data Type
Authorization	access_token value obtained from the Token endpoint.This is passed as "Bearer access_token "	string
AppKey	This is the Consumer Key provided during the App Registration process and is used to identify the user's application.	string
Content-Type	This is the content type of the payload being passed. Valid value is application/json.	string

Body Parameters

Name	Description	Data Type	Required
InitiationRequest		object

HTTP Responses

Code

Description
201

Opportunities Created.
400

Bad request - The server cannot or will not process the request due to an inaccurate request submitted by the client application. Please resubmit the request after making the required corrections indicated in the error response. For more Info on SEI Error Standards please refer to the API Standards FAQ under Support.
401

Unauthorized - Invalid authentication details have been provided. Also useful to trigger an authorization pop up if the API is used from a browser.
403

Forbidden-The SEI Server understood the request but refuses to fulfill it.
404

Not Found- The requested resource or the underlying resource does not exist. Please resubmit the request after making the required corrections
500

Internal Server Error - The SEI server was unable to fulfill the request due to an unknown condition. Please contact SEI for support. For More Info please refer to the "Response & Errors" FAQ under support.

TEST ENDPOINT

Authorization	access_token value obtained from the Token endpoint.This is passed as "Bearer access_token "
AppKey	This is the Consumer Key provided during the App Registration process and is used to identify the user's application.
Content-Type	This is the content type of the payload being passed. Valid value is application/json.

InitiationRequest

Request Body

Payload format required to create initiation orders.

HTTP Basic

Set...

OAuth 2.0

Set...

API Key

Set...

Working...

SAMPLE REQUEST

#SCENARIO 1: DIRECT INVESTOR
curl -X POST \
 https://api.seic.com/v1/trade/initiation \
  -H 'appkey: gsedgaerhDSHGRSH\
  -H 'authorization: Bearer ADsgdnnkjnfdIKJN; \
  -H 'cache-control: no-cache; \
  -H 'content-type: application/json; \
  -d {
  "data": [
    {
        "requestType": "New Subscription",
        "channel": "Direct",
        "opportunityGroupId": "string",
        "externalOrderId": "WWC_{{$timestamp}}",
        "firm": "string",
        "team": "string",
        "group": "string",
        "tradeDate": "2018-09-25T00:00:00Z",
        "orderDate": "2018-09-25T00:00:00Z",
        "eSign": true,
      "products": [
        {
          "productName": "Worldwide Capital Event Driven Fund, LP",
          "classIds": [
            "string"
          ],
          "amlRepLetter": true,
          "funds": [
            {
              "externalId": "string",
              "amount": 0,
              "currency": "string"
            }
          ]
        }
      ],     
     "investor": {
        "name": "John Doe Personal Trust",
        "externalId": "string",
        "subscriberType": "string",
        "accountNumber": "string",
        "contact": {
          "fullName": "string",
          "firstName": "string",
          "lastName": "string",
          "email": "jdoe@gmail.com",
          "externalId": "string"
        },
        "label": {
          "city": "string",
          "stateCode": "string",
          "postalCode": "string",
          "countryIsoCode": "string"
          "address1": "string",
          "address2": "string",
          "zip": "string"
        }
      }
    }
  ]
}

#SCENARIO 2: INVESTMENT ADVISOR
curl -X POST \
 https://api.seic.com/v1/trade/initiation \
  -H 'appkey: gsedgaerhDSHGRSH\
  -H 'authorization: Bearer ADsgdnnkjnfdIKJN; \
  -H 'cache-control: no-cache; \
  -H 'content-type: application/json; \
  -d {
  {
  "data": [
   {
        "requestType": "New Subscription",
        "channel": "Direct",
        "opportunityGroupId": "string",
        "externalOrderId": "WWC_{{$timestamp}}",
        "firm": "string",
        "team": "string",
        "group": "string",
        "tradeDate": "2018-09-25T00:00:00Z",
        "orderDate": "2018-09-25T00:00:00Z",
        "eSign": true,
      "products": [
        {
          "productName": "Worldwide Capital Event Driven Fund, LP",
          "classIds": [
            "string"
          ],
          "amlRepLetter": true,
          "funds": [
            {
              "externalId": "string",
              "amount": 0,
              "currency": "string"
            }
          ]
        }
      ],     
      "advisor": {
        "externalId": "string",
        "division": "string",
        "region": "string",
        "contact": {
          "fullName": "Test Advisor",
          "firstName": "string",
          "lastName": "string",
          "email": "testadvisor@gmail.com",
          "externalId": "string"
        },
        "label": {
          "city": "string",
          "stateCode": "string",
          "postalCode": "string",
          "countryIsoCode": "string"
          "address1": "string",
          "address2": "string",
          "zip": "string"
        }
      }
    }
  ]
}

#SCENARIO 3: INVESTOR AND ADVISOR
curl -X POST \
 https://api.seic.com/v1/trade/initiation \
  -H 'appkey: gsedgaerhDSHGRSH\
  -H 'authorization: Bearer ADsgdnnkjnfdIKJN; \
  -H 'cache-control: no-cache; \
  -H 'content-type: application/json; \
  -d {
  "data": [
   {
        "requestType": "New Subscription",
        "channel": "Direct",
        "opportunityGroupId": "string",
        "externalOrderId": "WWC_{{$timestamp}}",
        "firm": "string",
        "team": "string",
        "group": "string",
        "tradeDate": "2018-09-25T00:00:00Z",
        "orderDate": "2018-09-25T00:00:00Z",
        "eSign": true,
      "products": [
        {
          "productName": "Worldwide Capital Event Driven Fund, LP",
          "classIds": [
            "string"
          ],
          "amlRepLetter": true,
          "funds": [
            {
              "externalId": "string",
              "amount": 0,
              "currency": "string"
            }
          ]
        }
      ],    
      "advisor": {
        "externalId": "string",
        "division": "string",
        "region": "string",
        "contact": {
          "fullName": "Test Advisor",
          "firstName": "string",
          "lastName": "string",
          "email": "testadvisor@gmail.com",
          "externalId": "string"
        },
        "label": {
          "city": "string",
          "stateCode": "string",
          "postalCode": "string",
          "countryIsoCode": "string"
          "address1": "string",
          "address2": "string",
          "zip": "string"
        }
      },
      "investor": {
        "name": "John Doe",
        "externalId": "string",
        "subscriberType": "string",
        "accountNumber": "string",
        "contact": {
          "fullName": "John Doe",
          "firstName": "string",
          "lastName": "string",
          "email": "jdoe@gmail",
          "externalId": "string"
        },
        "label": {
          "city": "string",
          "stateCode": "string",
          "postalCode": "string",
          "countryIsoCode": "string"
          "address1": "string",
          "address2": "string",
          "zip": "string"
        }
      },
        }
      }
    }
  ]
}

#4 SCENARIO 4: FULL PAYLOAD
curl -X POST \
 https://api.seic.com/v1/trade/initiation \
  -H 'appkey: bAlFetvKS2D10zabqlYMATTlLlGbZFoN\
  -H 'authorization: Bearer b923809d37d0a21b7e1234f45cee528f5aec71224tf4b10e' \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -d '{
  "data": [
    {
      "requestType": "string",
      "channel": "string",
      "opportunityGroupId": "string",
      "externalOrderId": "string",
      "firm": "string",
      "team": "string",
      "group": "string",
      "tradeDate": "2020-11-03T00:06:43.772Z",
      "orderDate": "2020-11-03T00:06:43.772Z",
      "eSign": true,
      "products": [
        {
          "productName": "string",
          "classIds": [
            "string"
          ],
          "amlRepLetter": true,
          "funds": [
            {
              "externalId": "string",
              "amount": 0,
              "currency": "string"
            }
          ]
        }
      ],
      "advisor": {
        "externalId": "string",
        "division": "string",
        "region": "string",
        "contact": {
          "fullName": "string",
          "firstName": "string",
          "lastName": "string",
          "email": "string",
          "externalId": "string"
        },
        "label": {
          "city": "string",
          "stateCode": "string",
          "postalCode": "string",
          "countryIsoCode": "string",
          "address1": "string",
          "address2": "string",
          "zip": "string"
        }
      },
      "investor": {
        "name": "string",
        "externalId": "string",
        "subscriberType": "string",
        "accountNumber": "string",
        "contact": {
          "fullName": "string",
          "firstName": "string",
          "lastName": "string",
          "email": "string",
          "externalId": "string"
        },
        "label": {
          "city": "string",
          "stateCode": "string",
          "postalCode": "string",
          "countryIsoCode": "string",
          "address1": "string",
          "address2": "string",
          "zip": "string"
        }
      },
      "manager": {
        "fullName": "string",
        "firstName": "string",
        "lastName": "string",
        "email": "string",
        "externalId": "string"
      },
      "accessContacts": [
        {
          "access": "string",
          "contact": {
            "fullName": "string",
            "firstName": "string",
            "lastName": "string",
            "email": "string",
            "externalId": "string"
          },
          "label": {
            "countryIsoCode": "string"
          }
        }
      ],
      "formContacts": [
        {
          "contact": {
            "fullName": "string",
            "firstName": "string",
            "lastName": "string",
            "email": "string",
            "externalId": "string"
          },
          "label": {
            "countryIsoCode": "string"
          }
        }
      ],
      "custodians": [
        "string"
      ],
      "subForms": [
        {
          "id": "string"
        }
      ],
      "placementFee": [
        0
      ]
    }
  ]
}

REQUEST HEADER

Authorization: Bearer ADsgdnnkjnfdIKJN
AppKey: gsedgaerhDSHGRSH
Content-type: applciation/json

RESPONSE HEADER

Content-Type: application/json 
Status: 200 OK 
requesttrackingid: 67e1ff68-164f-03ad-0f2d-5cbbfda56ec9

SAMPLE RESPONSE

{
  "data": {
    "orders": [
      {
        "advisor": {
          "name": "string",
          "stateCode": "string"
        },
        "createdAt": "2020-11-03T15:00:51.576Z",
        "orderId": "string",
        "products": [
          {
            "name": "string",
            "trackingNumber": "string"
          }
        ],
        "accountNumber": "string",
        "opportunityGroupId": "string",
        "investorName": "string",
        "subform": [
          {
            "id": "string"
          }
        ],
        "placementFee": "string"
      }
    ],
    "faults": [
      {
        "code": "string",
        "message": "string",
        "userMessage": "string",
        "trackingId": "string",
        "transient": true
      }
    ]
  },
  "formatters": [
    {}
  ],
  "contentTypes": [
    {}
  ],
  "declaredType": "string",
  "statusCode": 200
}

MODEL

Operations

Name	Description	Data Type (L)
accountNumber	Code which uniquely identifies an individual or entity.	string
placementFees	Placement fees, only applicable for incoming transactions.	number(9)
faults.message	A developer specified message which accompanies the error.	string
faults.code	A semantic code which expresses the following {errorDomain}.{errorSubDomainOrResource}.{verb}.	string
faults.userMessage	A localized message based on the locale of the user. If unspecified, defaults to message.	string
faults.trackingId	A unique identifier which can be used to trace the logs.	string
faults.transient	Indicates if the error is temporary and the original request can be retried without any modifications.	string
content-type	Request content type. The valid values are application/xxx-form-url encoded.	string
orders	A Trade Initiation Request is called an order.	array
advisor	Field name stateCode	object
name	The business description for an entity in the context of the API, sometimes called a proper name. A name can apply to a Calendar, Financial Institution, Investor, Account, Advisor and various other entities.	string
stateCode	The two character code for US and Canadian states and provinces.	string
investorName	Investor full legal name as indicated on the subscription document.	string
createdAt	The date time the entity was created.	string
orderId	The Unique identifier of the order.	string
products	A collection of data points specific to an investment vehicles for which an investor is eligible to subscribe.	array
trackingNumber	A unique tracking number assigned to a specific request.	string

Subscription Initiation

POST

/trade/initiation

Prod:

https://api.seic.com/v1/trade/initiation

Header Parameters

Name	Description	Data Type
Authorization	access_token value obtained from the Token endpoint.This is passed as "Bearer access_token "	string
AppKey	This is the Consumer Key provided during the App Registration process and is used to identify the user's application.	string
Content-Type	This is the content type of the payload being passed. Valid value is application/json.	string

Body Parameters

Name	Description	Data Type	Required
InitiationRequest		object

HTTP Responses

Code

Description
201

Opportunities Created.
400

Bad request - The server cannot or will not process the request due to an inaccurate request submitted by the client application. Please resubmit the request after making the required corrections indicated in the error response. For more Info on SEI Error Standards please refer to the API Standards FAQ under Support.
401

Unauthorized - Invalid authentication details have been provided. Also useful to trigger an authorization pop up if the API is used from a browser.
403

Forbidden-The SEI Server understood the request but refuses to fulfill it.
404

Not Found- The requested resource or the underlying resource does not exist. Please resubmit the request after making the required corrections
500

Internal Server Error - The SEI server was unable to fulfill the request due to an unknown condition. Please contact SEI for support. For More Info please refer to the "Response & Errors" FAQ under support.

TEST ENDPOINT

Authorization	access_token value obtained from the Token endpoint.This is passed as "Bearer access_token "
AppKey	This is the Consumer Key provided during the App Registration process and is used to identify the user's application.
Content-Type	This is the content type of the payload being passed. Valid value is application/json.

InitiationRequest

Request Body

Payload format required to create initiation orders.

HTTP Basic

Set...

OAuth 2.0

Set...

API Key

Set...

Working...