AM/FA - Get Assigned Investing Organizations

Details

/external/v1/exclusivity

Synopsis

Get Assigned Investing Organizations

get

This route is used to extract all the investing organizations that have been assigned to an offering specified by a set of search filters. This endpoint is paginated, up to 50 records can be retrieved per call. This endpoint can be called by applications with access to scope "readExclusivityOptions".

Required scopes

This endpoint requires the following scopes:

• : readExclusivityOptions

Authorizations

oauth2

OAuth2clientCredentialsRequired

Token URL:

Query parameters

pageSizenumberOptional

The number of rows being retrieved. Must be a positive integer.

offsetnumberOptional

The offset (i.e. row start index). Must be a positive integer (or 0).

orgIdsFilterstringOptional

The comma delimited list of organization ids to filter the assignment records. Each record should not exceed 12 characters.

Example: USCCWSF01I00,USCCWSF01I01

securityIdsFilterstringOptional

The comma delimited list of security ids to filter the assignment records. Up to 10 records can be provided. Each record should not exceed 12 characters.

Example: USCCWSF01I00,USCCWSF01I01

securityCorrelationIdsFilterstringOptional

The comma delimited list of security correlation ids to filter the assignment records. Up to 10 records can be provided. Each record should not exceed 100 characters.

Example: 1234,5678,7890

securityCorrelationOrgIdstring · max: 12Optional

The organization identifier linked to the correlation ids provided in the "securityCorrelationIdsFilter" property. If not provided the organization id will be inferred from the access token.

assignmentStatusFilterstringOptional

The comma delimited list of statuses to filter the assignment records. Up to 4 entries can be provided. Available values: assigned, accepted, rejected, inactive

Example: assigned,accepted

Responses

200

Successfully extracted data

application/json

400

The following error codes can be returned: - GN0002 - GN0004 - GN0005 Please refer to the error code dictionary for the details of each error code.

application/json

401

The following error codes can be returned: - AU0001 Please refer to the error code dictionary for the details of each error code.

application/json

403

The following error codes can be returned: - AU0002 Please refer to the error code dictionary for the details of each error code.

application/json

get

/external/v1/exclusivity

HTTPcURLJavaScriptPython

GET /external/v1/exclusivity HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "orgId": "US9QIMA",
    "name": "State Street",
    "status": "assigned",
    "bookingModel": {
      "fbo": {
        "qualifiedTypes": [
          "Retirement"
        ]
      },
      "omnibus": {
        "qualifiedTypes": [
          "Individual",
          "Joint"
        ],
        "account": {
          "name": "Omnibus Account",
          "bankAccount": {
            "accountNumber": "111111111",
            "accountName": "savings account",
            "bankABA": "555555555",
            "bankName": "Test Bank",
            "bankSwift": "AAAA-BB-CC-123",
            "extraData": {
              "settlementInstructions": "Please wire the amount within 72 hours",
              "some": "Other Property"
            }
          },
          "contactInfo": [
            {
              "email": "[email protected]",
              "phoneNumber": "832-426-4242",
              "type": "primary"
            },
            {
              "email": "[email protected]",
              "phoneNumber": "987-564-1234",
              "type": "tax",
              "name": "John Doe",
              "description": "Use this contact for Tax Related Information (K-1, 1099 or other tax related information)"
            }
          ]
        }
      }
    },
    "isRepLetterProvided": true,
    "feesInfo": {
      "feesTemplateId": "US9QIMA",
      "name": "Fees Template Name",
      "status": "created",
      "managementFees": [
        {
          "feesInfo": [
            {
              "description": "IP: annually of capital commitments | 6 years from the date of initial investment",
              "value": 2,
              "unit": "percentage",
              "frequency": "Annually"
            },
            {
              "description": "Post-IP: annually on invested capital (remaining cost) | 11 years from the initial investment with 2 one-year extension options",
              "value": 1.5,
              "unit": "percentage",
              "frequency": "Annually"
            }
          ]
        }
      ],
      "investorServicingFees": [
        {
          "maxAmount": 9999.99,
          "feesInfo": [
            {
              "description": "IP: annually of capital commitments | 6 years from the date of initial investment",
              "value": 3,
              "unit": "percentage",
              "frequency": "Annually"
            },
            {
              "description": "Post-IP: annually on invested capital (remaining cost) | 11 years from the initial investment with 2 one-year extension options",
              "value": 2.5,
              "unit": "percentage",
              "frequency": "Annually"
            }
          ]
        },
        {
          "minAmount": 10000,
          "maxAmount": 49999.99,
          "feesInfo": [
            {
              "description": "IP: annually of capital commitments | 6 years from the date of initial investment",
              "value": 2,
              "unit": "percentage",
              "frequency": "Annually"
            },
            {
              "description": "Post-IP: annually on invested capital (remaining cost) | 11 years from the initial investment with 2 one-year extension options",
              "value": 1.5,
              "unit": "percentage",
              "frequency": "Annually"
            }
          ]
        }
      ],
      "otherFees": [
        {
          "groupName": "Global fees",
          "groupDetails": [
            {
              "feesInfo": [
                {
                  "description": "Some global fee",
                  "value": 75,
                  "unit": "basisPoints",
                  "frequency": "One-Off"
                }
              ]
            }
          ]
        },
        {
          "groupName": "Bank fees",
          "groupDetails": [
            {
              "maxAmount": 4999.99,
              "feesInfo": [
                {
                  "description": "Bank fees - tier 1 - $5,000,000 - $9,999,999",
                  "value": 50,
                  "unit": "basisPoints",
                  "frequency": "One-Off"
                }
              ]
            },
            {
              "minAmount": 5000,
              "maxAmount": 999999.99,
              "feesInfo": [
                {
                  "description": "Bank fees - tier 2 - $10,000,000+",
                  "value": 25,
                  "unit": "basisPoints",
                  "frequency": "One-Off"
                }
              ]
            }
          ]
        }
      ],
      "maxFrontendFee": 1,
      "backendFee": 0
    },
    "role": "investor",
    "securityId": "USCCWSF01I01"
  }
]

Important Notes

• securityId: identifier for the fund/offering. See Managing the SecurityId.