AM/TA - 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

orgIdstringRequired

The id of the assigned organization. Used to uniquely identify the organization on the ledger

Example: US9QIMA

namestringRequired

The name of the assigned organization

Example: State Street

statusall ofRequired

The status of the assignment: - assigned: eligible to be accepted/rejected - accepted: eligible to be rejected - rejected: eligible to be accepted - inactive: it means that the organization is not assigned to this particular security. The typical use case is when an investing organization is only assigned to a subset of share classes. All the share classes to which the investing organization was not assigned to will have this status. Also, if an organization was removed from the exclusivity list it will also have this status.

Example: assigned

string · enumOptional

The status of the assignment: - assigned: eligible to be accepted/rejected - accepted: eligible to be rejected - rejected: eligible to be accepted - inactive: it means that the organization is not assigned to this particular security. The typical use case is when an investing organization is only assigned to a subset of share classes. All the share classes to which the investing organization was not assigned to will have this status. Also, if an organization was removed from the exclusivity list it will also have this status.

Possible values:

isRepLetterProvidedbooleanOptional

This value is set to true if the issuer of the security has a rep letter from the distribution partner being assigned to the exclusivity list. Otherwise it is set to false.

Default: falseExample: true

roleall ofRequired

The role of assigned organization.

Example: investor

string · enumOptional

The role of assigned organization.

Possible values:

securityIdstringRequired

The id of the security organization is assigned to. Used to uniquely identify the security on the ledger

Example: USCCWSF01I01

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