Initiation

PostTrade

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

OAuth 2.0

API Key

Working...

Initiation

PostTrade

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

OAuth 2.0

API Key

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

PostTrade

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

OAuth 2.0

API Key

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

PostTrade

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

OAuth 2.0

API Key

Working...

Initiation

PostTrade

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

OAuth 2.0

API Key

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



STEP 2

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

Initiation

PostTrade

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

OAuth 2.0

API Key

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

PostTrade

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

OAuth 2.0

API Key

Working...