SEI Developer Portal

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...

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.

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

REQUEST PAYLOAD MODEL

Operations

Name	Description	Data Type (L)
amount	Debit Credit Amount	string
addressLine1	The first line of the address, typically used for the street address.	string(60)
addressLine2	The second line of the address.	string(60)
placementFees	Placement fees, only applicable for incoming transactions.	number(9)
id	The SEI system's internal identifier for an Account, position, lot, transaction, investor, product or any other entity indicated by the object grouping in the API response.	string
requestType	One of three values that determine the kit which drives the process and form details that will need to be completed (i.e., 'New Subscription'). The other fields are channel and productName.	string
channel	Intermediate through which the investor came into the product.	string
externalOrderId	An optional identifier that can be captured and used to ensure that duplicate requests are not initiated and also can be used as a way to link specific requests from disparate systems.	string
firmId	The identifier of the firm.	string
team	The identifier of the team.	string
group	An optional identifier that can be used to link a group to an Opportunity.	object
tradeDate	The date the order was executed, e.g., the effective date, in format yyyy-MM-ddTHH:mm:ss.SSS. Datetime is Eastern Standard Time (EST).	string
orderDate	The date and time that this request has been made,	string
eSign	Determines if electronic signature is used in this Opportunity.	string
productName	One of three values that determine the kit which drives the process and form details that will need to be completed (i.e. WWC Event Driven Fund, L.P.). The other fields are requestType and and channel.	string
className	Enables access to a certain fund class which may drive access to certain documentation.	string
amlRepLetter	Determines if an AML Rep Letter is required for the product.	string
externalId	Unique business identifier that represents a contact, investor, product, transaction or alternate entity recognized by SEI and a third party system or application. Many times the externalId is used to synchronize SEI sourced data with another data source for the same record.	string
currency	ISO 4217 alphabetic code	string
division	A division within the advisory firm, if applicable.	string
region	The region of the world associated with the calendar with the options being (Africa, Americas, Asia, Europe, Global and Middle East).	string
fullName	The full legal name of the investor,manager or contact or any other entity represented by the object grouping of the field in the JSON response structure.	string(250)
firstName	The first name for the financial advisor, investor,manager or contact or third party	string(50)
lastName	The last name for the financial advisor, investor,manager or contact or third party	string(50)
email	The email address at which communications can be sent or received.	string
city	The city of the address.	string(60)
stateCode	The two character code for US and Canadian states and provinces.	string
postalCode	The postal code of the address.	string
countryIsoCode	ISO country code ISO 3166-1 alpha-2 code format.	string
access	Describes the access the contact should have in SEI Trade. Possible values are 'read', 'readwrite' or blank.	string
custodianId	The SEI unique identifier of the custodian.	string
products	A collection of data points specific to an investment vehicles for which an investor is eligible to subscribe.	array
investor	Indicates the external investor ID related to the contact relationship.	object
name	The first, last, and middle name of the user as available in the SEI application.	string
contact	A collection of data that describes a contact, such as name, email and an external identifier.	object
accountNumber	Code which uniquely identifies an individual or entity.	string
labels	Additional attributes associated with the investor, financial advisor, manager or other contact identified in the investment opportunity.	object
advisor	Field name stateCode	object
subscriberType	Investor's subscriber type as indicated on the subscription document. A full list of subscriber types can be obtained through the Lists API.	string
manager	The name of the product manager.	object
funds	An array of products specific to the opportunity in SEI Trade.	array
firm	An optional identifier that can be used to link a Firm to an Opportunity.	object

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

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...

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.

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

REQUEST PAYLOAD MODEL

Operations

Name	Description	Data Type (L)
amount	Debit Credit Amount	string
addressLine1	The first line of the address, typically used for the street address.	string(60)
addressLine2	The second line of the address.	string(60)
placementFees	Placement fees, only applicable for incoming transactions.	number(9)
id	The SEI system's internal identifier for an Account, position, lot, transaction, investor, product or any other entity indicated by the object grouping in the API response.	string
requestType	One of three values that determine the kit which drives the process and form details that will need to be completed (i.e., 'New Subscription'). The other fields are channel and productName.	string
channel	Intermediate through which the investor came into the product.	string
externalOrderId	An optional identifier that can be captured and used to ensure that duplicate requests are not initiated and also can be used as a way to link specific requests from disparate systems.	string
firmId	The identifier of the firm.	string
team	The identifier of the team.	string
group	An optional identifier that can be used to link a group to an Opportunity.	object
tradeDate	The date the order was executed, e.g., the effective date, in format yyyy-MM-ddTHH:mm:ss.SSS. Datetime is Eastern Standard Time (EST).	string
orderDate	The date and time that this request has been made,	string
eSign	Determines if electronic signature is used in this Opportunity.	string
productName	One of three values that determine the kit which drives the process and form details that will need to be completed (i.e. WWC Event Driven Fund, L.P.). The other fields are requestType and and channel.	string
className	Enables access to a certain fund class which may drive access to certain documentation.	string
amlRepLetter	Determines if an AML Rep Letter is required for the product.	string
externalId	Unique business identifier that represents a contact, investor, product, transaction or alternate entity recognized by SEI and a third party system or application. Many times the externalId is used to synchronize SEI sourced data with another data source for the same record.	string
currency	ISO 4217 alphabetic code	string
division	A division within the advisory firm, if applicable.	string
region	The region of the world associated with the calendar with the options being (Africa, Americas, Asia, Europe, Global and Middle East).	string
fullName	The full legal name of the investor,manager or contact or any other entity represented by the object grouping of the field in the JSON response structure.	string(250)
firstName	The first name for the financial advisor, investor,manager or contact or third party	string(50)
lastName	The last name for the financial advisor, investor,manager or contact or third party	string(50)
email	The email address at which communications can be sent or received.	string
city	The city of the address.	string(60)
stateCode	The two character code for US and Canadian states and provinces.	string
postalCode	The postal code of the address.	string
countryIsoCode	ISO country code ISO 3166-1 alpha-2 code format.	string
access	Describes the access the contact should have in SEI Trade. Possible values are 'read', 'readwrite' or blank.	string
custodianId	The SEI unique identifier of the custodian.	string
products	A collection of data points specific to an investment vehicles for which an investor is eligible to subscribe.	array
investor	Indicates the external investor ID related to the contact relationship.	object
name	The first, last, and middle name of the user as available in the SEI application.	string
contact	A collection of data that describes a contact, such as name, email and an external identifier.	object
accountNumber	Code which uniquely identifies an individual or entity.	string
labels	Additional attributes associated with the investor, financial advisor, manager or other contact identified in the investment opportunity.	object
advisor	Field name stateCode	object
subscriberType	Investor's subscriber type as indicated on the subscription document. A full list of subscriber types can be obtained through the Lists API.	string
manager	The name of the product manager.	object
funds	An array of products specific to the opportunity in SEI Trade.	array
firm	An optional identifier that can be used to link a Firm to an Opportunity.	object

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

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...