Intermediated placement

Vasco supports a multichannel distribution model where investments can be sold either directly by the issuer or through a network of professional distributors. Understanding the distribution layer is important when integrating Vasco.

Distributors

A Distributor is a professional entity (a company) that is authorized to market and distribute investment products on behalf of the issuer. Distributors manage their own clients (Investors) and have access to those investors' accounts.

Key attributes:

Attribute	Description
id	Unique identifier
label	Distributor company name
kycStatusDetailed	The distributor's own KYD/compliance status

A distributor authenticates with the API using their own credentials and can query only the accounts and investments that belong to their client base.

query {
  GetDistributors(isActive: true) {
    edges {
      node {
        id
        label
        kycStatusDetailed {
          code
          label
        }
        corporateAccount {
          id
          corporateInfo {
            corporateName
          }
        }
        vatPercentage
        distributorNetwork {
          id
          corporateAccount {
            id
            corporateInfo {
              corporateName
            }
          }
        }
        # ...Other Distributor fields
      }
    }
    totalCount
  }
}

→ Type reference: Distributor

Advisors

A Distributor Advisor (DistributorAdvisor) is a natural person who works on behalf of a Distributor. Advisors directly manage investor relationships and are typically the primary point of contact for the end client.

Key attributes:

Attribute	Description
id	Unique identifier
firstName / lastName	Personal identity
email	Work email
distributor	The parent Distributor this advisor belongs to

An Advisor can be assigned to accounts: the distributedByAdvisor field on an Account or Investment tells you which advisor is responsible for said Account or Investment.

query {
  GetDistributorAdvisors(distributorId: "123") {
    edges {
      node {
        id
        user {
          id
          email
        }
        distributor {
          id
        }
        # ...Other DistributorAdvisor fields
      }
    }
    totalCount
  }
}

→ Type reference: DistributorAdvisor

Distributor Network

A DistributorNetwork is a parent organization that groups multiple Distributors. It acts as a network head with oversight and reporting capabilities over all Distributors in its network.

Key attributes:

Attribute	Description
id	Unique identifier
label	Network name
kycStatus	The network's own compliance status

A user with the distributor_network persona can query Accounts distributed through any of the Distributors in their network.

How Distribution Affects Accounts

When an Account is created through a distribution channel:

• The Account's distributedByAdvisor field points to the Advisor in charge of this Account
• Through that field, you can reach the Account's distributor field which will sport information regarding the distributing company

query {
  GetAccount(id: "123") {
    label
    distributedByAdvisor {
      id
      user {
        id
        firstName
        lastName
      }
      distributor {
        id
        corporateAccount {
          corporateInfo {
            corporateName
          }
        }
      }
    }
    user {
      id
      email
    }
  }
}

Related Queries & Mutations

Operation	Reference
List distributors	GetDistributors
Fetch a single distributor	GetDistributor
List advisor profiles	GetDistributorAdvisors
List distributor networks	GetDistributorNetworks