The Vasco API is built respecting the GraphQL specifications.

Read more on : https://graphql.org/

To authenticate you on the API, you need to provide a token in the Authorization header.

This token is a JWT. You can retrieve it by making a POST request to /auth/login

Body :

{
  "username": "user@test.com",
  "password": "pass"
}

The response will contain a token in such a format:

{
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpXXXXXX.YYYYYY"
}

You have to make your next API calls using this Token in Authorization header:

POST /graphql/
            Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpXXXXXX.YYYYYY
            
            ....
            

File download endpoints (outside GraphQL schema)

Some downloads are exposed outside the GraphQL API because of their return format. They require the same JWT as the authenticated API and return a file directly (or a JSON message on error).

SEPA files

• SEPA credit transfer for security operations (Distribution, Transfer)
  GET /security_operations/{securityOperationId}/download-sepa/credit_transfer (admin only)

  • all=true triggers async generation for all movements (can be combined with search and filter[bankAccountStatus]).
  • Otherwise, pass targeted IDs via moneyMovementIds[]=....
  • Examples:
    • GET /security_operations/123/download-sepa/credit_transfer?all=true&filter[bankAccountStatus]=verified
    • GET /security_operations/123/download-sepa/credit_transfer?moneyMovementIds[]=10&moneyMovementIds[]=11
  • Returns a sepa.xml file or a JSON / 202 message in async mode.

• SEPA direct debit
  GET /security_operations/download-sepa/direct_debit (admin only)

  • Requires the array transactions[transactionId]=securityOperationId listing the transactions to include.
  • Example: GET /security_operations/download-sepa/direct_debit?transactions[42]=1337&transactions[43]=1337
  • Returns a sepa.xml file.

• SEPA for retrocession invoices
  GET /retrocessions-invoices/download-sepa (admin only)

  • Parameter invoices[]=<invoiceId> for each invoice to include.
  • Example: GET /retrocessions-invoices/download-sepa?invoices[]=9811&invoices[]=9812
  • Returns a sepa.xml file.

Subscription packs (3 routes)

• GET /investments/{investmentId}/download-blank-subscription-pack-for-verification.zip
  Preview of the subscription pack for verification before approving investment terms.
• GET /investments/{investmentId}/download-blank-subscription-pack.zip
  Pack to be signed. Available once investment terms are validated. Marks the investment as manually signed.
• GET /investments/{investmentId}/download-blank-subscription-pack-for-electronic-sign.zip
  Variant for electronic signature (does not force manual mode).

Transaction document archives (5 routes)

Admin and distributor only. Each route returns a .zip archive with the documents visible for the targeted transaction.

• GET /investments/{id}/subscription-pack-documents.zip
• GET /capital-call/{id}/documents.zip
• GET /distributions/{id}/documents.zip
• GET /cessions/{id}/documents.zip
• GET /transfers/{id}/documents.zip

2026-01-15

Breaking changes

• Mutation CreateMessageBlock need a new argument name. It is not mandatory for the moment, but will be mandatory on April 2026.

Deprecations

• persona and personaDetailed fields of AdminUser, DistributorAdvisorUser, DistributorNetworkUser, DistributorUser, InvestorUser and User are deprecated. Use userGroup instead.

Informations

• Enum value AdminFeesAndRetrocessions was added to enum DataTableType
• Enum value AdvisorAccounts was added to enum DataTableType
• Enum value AdvisorUsers was added to enum DataTableType
• Enum value DistributorAccounts was added to enum DataTableType
• Enum value DistributorAdvisorFeesAndRetrocessions was added to enum DataTableType
• Enum value DistributorFeesAndRetrocessions was added to enum DataTableType
• Enum value DistributorNetworkAccounts was added to enum DataTableType
• Enum value DistributorNetworkFeesAndRetrocessions was added to enum DataTableType
• Enum value DistributorNetworkUsers was added to enum DataTableType
• Enum value DistributorUsers was added to enum DataTableType
• Enum value AdditionalIncome was added to enum DistributionType
• Enum value DocumentStyle was added to enum EntityName
• Enum value Rememberment was added to enum EntityName
• Enum value SecurityFeeExit was added to enum EntityName
• Enum value SecurityOperationRememberment was added to enum EntityName
• Enum value UserGroup was added to enum EntityName
• Enum value UserGroupTranslation was added to enum EntityName
• Enum value AmountCeded was added to enum FeeCalculationBasis
• Enum value AtExit was added to enum FeeCalculationPeriodicity
• Enum value ExitFees was added to enum FeeType
• Enum value NoValidationDate was added to enum RetrocessionState
• Enum value CanAccessEnvironmentCmsBlock was added to enum Role
• Enum value CanAccessInvestmentSecurityOperation was added to enum Role
• Enum value CanDeleteAccount was added to enum Role
• Enum value CanListUnlistedTeams was added to enum Role
• Enum value CanManageEnvironmentCmsBlock was added to enum Role
• Enum value CanManageInvestmentSecurityOperation was added to enum Role
• Argument userGroupId: ID added to field RootMutation.CreateAdmin
• Argument distributorAdvisorId: ID added to field RootMutation.CreateCorporateAccount
• Argument distributorAdvisorId: ID added to field RootMutation.CreateIndividualAccount
• Argument distributorAdvisorId: ID added to field RootMutation.CreateJointAccount
• Argument localizedName: [LocalizedStringInput] added to field RootMutation.CreateMessageBlock
• Argument sortIndex: Int added to field RootMutation.CreateMessageBlock
• Argument documentStyleId: ID added to field RootMutation.UpdateDocumentTemplateContentHtml
• Argument localizedName: [LocalizedStringInput] added to field RootMutation.UpdateMessageBlock
• Argument name: String added to field RootMutation.UpdateMessageBlock
• Argument sortIndex: Int added to field RootMutation.UpdateMessageBlock
• Argument userGroupId: ID added to field RootMutation.UpdateUserInfosAndPermissions
• Argument accountId: ID added to field RootQuery.GetAccountSecurityContracts
• Argument accountId: ID added to field RootQuery.GetCommunication
• Argument accountId: ID added to field RootQuery.GetCommunications
• Argument date: Date added to field RootQuery.GetTransactionFlowDebugOutput
• Default value {} was added to argument filters on field RootQuery.GetUsers
• Enum value SecurityOperationRememberment was added to enum SecurityOperationType
• Enum value Rememberment was added to enum TransactionType
• Field taxArrangement was added to interface AccountSecurityContract
• Field userGroup was added to object type AdminUser
• Field taxArrangement was added to object type AutomaticDistributionReinvestmentContract
• Type ComplianceControlSourceCategory was added
• Type ComplianceControlSourceCategoryDetailed was added
• Field Configuration.displayableMessageBlock description changed from The message block to display conditionally to The legacy message block to display conditionally
• Field displayableMessageBlocks was added to object type Configuration
• Field Configuration.messageBlockConfiguration description changed from The data to configure the message block to The data to configure the legacy message block
• Field messageBlocksConfiguration was added to object type Configuration
• Field signinCmsBlocks was added to object type Configuration
• Field signupCmsBlocks was added to object type Configuration
• Field taxArrangementBankAccount was added to object type ConsolidatedTransaction
• Field lastDownloadedExport was added to object type CustomExport
• Field technicalCode was added to object type DataTableTypeDetailed
• Field userGroup was added to object type DistributorAdvisorUser
• Field userGroup was added to object type DistributorNetworkUser
• Field userGroup was added to object type DistributorUser
• Type DocumentStyle was added
• Field documentStyle was added to object type DocumentTemplateContentHtml
• Type FilterSetTaxationTypeInput was added
• Field isin was added to object type FundShare
• Input field taxationType of type FilterSetTaxationTypeInput was added to input object type InvestmentFiltersInput
• Field userGroup was added to object type InvestorUser
• Field localizedName was added to object type MessageBlock
• Field name was added to object type MessageBlock
• Field sortIndex was added to object type MessageBlock
• Field priority was added to object type PaymentMethodDetailed
• Field taxArrangement was added to object type RecurrenceContract
• Input field customName of type String was added to input object type RepartitionDistributionInput
• Field customName was added to object type RepartitionDistributionType
• Type RoleCategory was added
• Type RoleCategoryDetailed was added
• Type RoleDetailed was added
• Field CreateSecurityExitFee was added to object type RootMutation
• Field DeleteAccount was added to object type RootMutation
• Field DeleteSecurity was added to object type RootMutation
• Field UpdateMessageBlockSettings was added to object type RootMutation
• Field UpdateSecurity was added to object type RootMutation
• Field UpdateSecurityExitFee was added to object type RootMutation
• Field UpdateSecurityOperationStatus was added to object type RootMutation
• Type for argument userId on field RootQuery.GetAccountSecurityContracts changed from ID! to ID
• Field GetComplianceControlSourceCategories was added to object type RootQuery
• Field GetDocumentStyles was added to object type RootQuery
• Field GetEntityPropertyReferentials was added to object type RootQuery
• Field GetFeeCalculationBasis was added to object type RootQuery
• Field GetFeeCalculationMethods was added to object type RootQuery
• Field GetFeeCalculationPeriodicities was added to object type RootQuery
• Field GetFeeCalculationTypes was added to object type RootQuery
• Field GetLatestDocumentStyle was added to object type RootQuery
• Field GetNotificationTypeCategories was added to object type RootQuery
• Field GetNotificationTypeIds was added to object type RootQuery
• Field GetNotificationTypeStatuses was added to object type RootQuery
• Field GetPaymentMethods was added to object type RootQuery
• Field GetRoleCategories was added to object type RootQuery
• Field GetRoles was added to object type RootQuery
• Field GetSecurityOperationDocumentGenerationTriggers was added to object type RootQuery
• Field GetUserGroups was added to object type RootQuery
• Type SecurityFeeExit was added
• Field userGroup was added to interface User
• Input field distributorAdvisorId of type ID was added to input object type UserFiltersInput
• Input field distributorId of type ID was added to input object type UserFiltersInput
• Input field distributorNetworkId of type ID was added to input object type UserFiltersInput
• Input field UserFiltersInput.segmentId changed type from ID! to ID
• Type UserGroup was added

2025-11-10

Breaking changes

• For all types inheriting from [type User] :
  • field firstName changed type from String! to String
  • field lastName changed type from String! to String
• With the introduction af validation date on [type Cession]:
  • Argument documentGeneration: DocumentGenerationInput! is deprecated and have no effect in [mutation SetCessionPaymentDate]. Use it on [mutation SetCessionValidationDate] instead.
  • Argument endEffectiveDate: Date! is deprecated and have no effect in [mutation SetCessionPaymentDate]. Use it on [mutation SetCessionValidationDate] instead.
  • Argument withEmail: Boolean! is deprecated and have no effect in [mutation SetCessionPaymentDate]. Use it on [mutation SetCessionValidationDate] instead.
• With the introduction af validation date on [type Transfer]:
  • Argument documentGeneration: DocumentGenerationInput! is deprecated and have no effect in [mutation SetTransferPaymentDate]. Use it on [mutation SetTransferValidationDate] instead.
  • Argument endEffectiveDate: Date! is deprecated and have no effect in [mutation SetTransferPaymentDate]. Use it on [mutation SetTransferValidationDate] instead.
  • Argument withEmailCreditorTransfer: Boolean! is deprecated and have no effect in [mutation SetTransferPaymentDate]. Use it on [mutation SetTransferValidationDate] instead.
  • Argument withEmailDebtorTransfer: Boolean! is deprecated and have no effect in [mutation SetTransferPaymentDate]. Use it on [mutation SetTransferValidationDate] instead.
• Input field userEmail was renamed to toAccountEmail in input object type InvestmentFiltersInput
• Query GetTransactionMoneyMovements changed type from [TransactionMoneyMovement] to [type TransactionMoneyMovementConnection]

Informations

• Enum value AdminAccountFlowMonitoringV2 was added to enum DataTableType
• Enum value NewUserAccessNotification was added to enum NotificationTypeId
• Enum value UserAddedToAccount was added to enum NotificationTypeId
• Enum value CanEditTransactionFee was added to enum Role
• Enum value CanManageAccountAccess was added to enum Role
• Enum value CanManageCommentAccount was added to enum Role
• Argument firstName: String added to field RootMutation.AcknowledgeTos
• Argument lastName: String added to field RootMutation.AcknowledgeTos
• Argument phoneNumber: String added to field RootMutation.AcknowledgeTos
• Argument customAccesses: [UserAccountInput!] added to field RootMutation.CreateCorporateAccount
• Argument email: String added to field RootMutation.CreateCorporateAccount
• Argument mobile: String added to field RootMutation.CreateCorporateAccount
• Argument sendNotificationEmail: Boolean (with default value) added to field RootMutation.CreateCorporateAccount
• Argument customAccesses: [UserAccountInput!] added to field RootMutation.CreateIndividualAccount
• Argument email: String added to field RootMutation.CreateIndividualAccount
• Argument firstName: String added to field RootMutation.CreateIndividualAccount
• Argument lastName: String added to field RootMutation.CreateIndividualAccount
• Argument mobile: String added to field RootMutation.CreateIndividualAccount
• Argument sendNotificationEmail: Boolean (with default value) added to field RootMutation.CreateIndividualAccount
• Argument customAccesses: [UserAccountInput!] added to field RootMutation.CreateJointAccount
• Argument email: String added to field RootMutation.CreateJointAccount
• Argument firstName: String added to field RootMutation.CreateJointAccount
• Argument lastName: String added to field RootMutation.CreateJointAccount
• Argument mobile: String added to field RootMutation.CreateJointAccount
• Argument sendNotificationEmail: Boolean (with default value) added to field RootMutation.CreateJointAccount
• Argument accountId: ID added to field RootQuery.GetTransactionMoneyMovements
• Argument page: Int (with default value) added to field RootQuery.GetTransactionMoneyMovements
• Argument resultsPerPage: Int added to field RootQuery.GetTransactionMoneyMovements
• Argument securityId: ID added to field RootQuery.GetTransactionMoneyMovements
• Argument status: TransactionMoneyMovementState added to field RootQuery.GetTransactionMoneyMovements
• Argument transactionType: TransactionType added to field RootQuery.GetTransactionMoneyMovements

2025-10-16

Breaking changes

• No breaking changes

Informations

• For all types inheriting from [type Account] :
  • Argument userId: ID added to field Account.user
• Enum value DismembermentEndDateComputation was added to enum AlgorithmTechnicalCode
• Enum value AdminAccounts was added to enum DataTableType
• Enum value RecallableDistribution was added to enum DistributionType
• Enum value AlgorithmTranslation was added to enum EntityName
• Input field recallablePercentage of type Float was added to input object type RepartitionDistributionInput
• Enum value CanAccessContractOptions was added to enum Role
• Enum value CanAccessGlobalDms was added to enum Role
• Enum value CanManageAllKycComments was added to enum Role
• Enum value CanManageOwnKycComments was added to enum Role
• Argument dryRun: Boolean! (with default value) added to field RootMutation.PairPendingDismemberedInvestments
• Enum value Blocked was added to enum TransactionMoneyMovementState

2025-09-08

Breaking changes

• type AccountSecurityContract has now 2 children:

  • types:
    • AutomaticDistributionReinvestmentContract
    • RecurrenceContract
  • AccountSecurityContract kind changed from ObjectTypeDefinition to InterfaceTypeDefinition

• type Country:

  • Field preferredChoice was removed

• Entity Proprties:

  • Field EntityPropertyDocument.accountDocumentType is nullable

• Field NotificationType.label changed type from String! to String

• type Role:

  • value CanExportProtectedTablesGroup1 was replaced by:
    • CanExportInvoices
    • CanExportRetrocessions
  • value CanExportProtectedTablesGroup2 was replaced by:
    • CanExportAccounts
    • CanExportDistributors
    • CanExportUsers

• mutation SetTransferPaymentDate

  • replace withEmail: Boolean! on by:
    • withEmailCreditorTransfer: Boolean!
    • withEmailDebtorTransfer: Boolean!

• type SecurityOperationInvestmentType:

  • Enum value ScheduledSubscriptions was replaced by ScheduledSubscriptionsFullOwnership

• type TransactionMoneyMovementState:

  • Enum value CREATED was replaced by Created in Queries. In Mutations, both are working, the first one is deprecated and will soon be removed.
  • Enum value REFUSED was replaced by Refused in Queries. In Mutations, both are working, the first one is deprecated and will soon be removed.
  • Enum value SUCCEEDED was replaced by Succeeded in Queries. In Mutations, both are working, the first one is deprecated and will soon be removed.

Informations

• Input field validationDate of type FilterDateWithConditionInput was added to input object type InvestmentFiltersInput
• Enum value InvestmentModalitiesToComplete was added to enum NotificationTypeId
• Enum value InvestmentPaymentInformation was added to enum NotificationTypeId
• Enum value KycCompletionInvitation was added to enum NotificationTypeId
• Enum value SubscriptionPackSignatureInvitation was added to enum NotificationTypeId
• Enum value SubscriptionValidated was added to enum NotificationTypeId
• Enum value CanEditInvestment was added to enum Role
• Enum value CanEditKyc was added to enum Role
• Argument onlyDisplayed: Boolean added to field RootQuery.GetCountries
• Argument accountId: ID added to field RootQuery.GetDmsDocuments
• Argument userId: ID added to field RootQuery.GetDmsDocuments
• Enum value ScheduledSubscriptionsBareOwnership was added to enum SecurityOperationInvestmentType
• Enum value Created was added to enum TransactionMoneyMovementState
• Enum value Refused was added to enum TransactionMoneyMovementState
• Enum value Succeeded was added to enum TransactionMoneyMovementState
• Enum value PendingValidation was added to enum TransactionState

Safe changes

• Field locale was added to object type AdminUser
• Field localeDetailed was added to object type AdminUser
• Type AutomaticDistributionReinvestmentContract was added
• Field paymentMethodDetailed was added to object type BankCheckPaymentInformation
• Type CompanyType was added
• Type CompanyTypeDetailed was added
• Field entityPropertyContext was added to object type ConfigurableFormQuestion
• Field isPreProd was added to object type Configuration
• Field paginationDefaultResultsNumber was added to object type Configuration
• Field urlPreProd was added to object type Configuration
• Field urlProd was added to object type Configuration
• Field sortIndex was added to object type Country
• Field paymentMethodDetailed was added to object type CreditTransferPaymentInformation
• Field paymentMethodDetailed was added to object type DirectDebitPaymentInformation
• Field needDuration was added to object type DismembermentTypeDetailed
• Field needUsufructuaryAge was added to object type DismembermentTypeDetailed
• Field locale was added to object type DistributorAdvisorUser
• Field localeDetailed was added to object type DistributorAdvisorUser
• Field locale was added to object type DistributorNetworkUser
• Field localeDetailed was added to object type DistributorNetworkUser
• Field locale was added to object type DistributorUser
• Field localeDetailed was added to object type DistributorUser
• Type DocumentGenerationBehaviourDetailed was added
• Field localizedName was added to interface DocumentTemplate
• Field localizedContent was added to object type DocumentTemplateContentHtml
• Field localizedName was added to object type DocumentTemplateContentHtml
• Field localizedName was added to object type DocumentTemplateFillablePdf
• Field documentType was added to object type EntityPropertyDocument
• Type FilterNullSafeNumberInput was added
• Type FilterNullSafeNumberOperator was added
• Type FilterNullSafeNumberWithConditionInput was added
• Field signatureLink was added to object type Investment
• Field validationDate was added to object type Investment
• Field locale was added to object type InvestorUser
• Field localeDetailed was added to object type InvestorUser
• Type LocalizedOperationFinancingInfoIndicator was added
• Type LocalizedOperationFinancingInfoIndicatorInput was added
• Field localizedContent was added to object type MessageBlock
• Field allowDefaultNotificationSetup was added to object type NotificationType
• Field enableSendingByDefault was added to object type NotificationType
• Field localizedContent was added to object type NotificationType
• Field localizedLabel was added to object type NotificationType
• Field localizedSubject was added to object type NotificationType
• Field alternativeSignatureMethods was added to object type Operation
• Field excludedSegments was added to object type Operation
• Field includedSegments was added to object type Operation
• Field localizedDescription was added to object type Operation
• Field preferredSignatureMethod was added to object type Operation
• Field securityOperationInvestmentWithoutDocuments was added to object type Operation
• Field subscribedAtUnknownNav was added to object type Operation
• Type OperationExcludedSegment was added
• Field localizedIndicators was added to object type OperationFinancingInfo
• Type OperationFinancingInfoIndicatorInput was added
• Type OperationIncludedSegment was added
• Field paymentMethodDetailed was added to interface PaymentInformation
• Type PublicNotificationType was added
• Type RecurrenceContract was added
• Field sortIndex was added to object type ReferentialChoice
• Type for argument accountDocumentTypeId on field RootMutation.CreateEntityPropertyDocument changed from ID! to ID
• Field DeleteOperationDocument was added to object type RootMutation
• Field SendEmailInvestmentModalitiesToComplete was added to object type RootMutation
• Field SendInvestmentPaymentInformationEmail was added to object type RootMutation
• Field SendKycCompletionInvitationEmail was added to object type RootMutation
• Field SendSignatureInvitation was added to object type RootMutation
• Type for argument accountDocumentTypeId on field RootMutation.UpdateEntityPropertyDocument changed from ID! to ID
• Field UploadOperationDocument was added to object type RootMutation
• Field ValidateSubscription was added to object type RootMutation
• Field GetAccountTypes was added to object type RootQuery
• Field GetAlgorithmTechnicalCodes was added to object type RootQuery
• Field GetCompanyTypes was added to object type RootQuery
• Field GetDismembermentTypes was added to object type RootQuery
• Field GetDistributionPeriodicities was added to object type RootQuery
• Field GetDistributionTaxations was added to object type RootQuery
• Field GetDistributionTypes was added to object type RootQuery
• Field GetDocumentControlStatus was added to object type RootQuery
• Field GetDocumentGenerationBehaviours was added to object type RootQuery
• Field GetEntityPropertyTypes was added to object type RootQuery
• Field GetFeeTypes was added to object type RootQuery
• Field RootQuery.GetFormQuestionDataStrategyDefinitions changed type from [FormQuestionDataStrategyDefinitionDetailed] to [FormQuestionDataStrategyDefinitionDetailed]!
• Field GetFormQuestionEntityPropertyContextChoices was added to object type RootQuery
• Field GetInvestorsSelectionStrategies was added to object type RootQuery
• Description for argument search on field RootQuery.GetInvoices changed from Term to search in distributor name, invoice number or vehicule name to Term to search in distributor name, invoice number or vehicle name
• Field GetOperationStates was added to object type RootQuery
• Field GetOperationTypes was added to object type RootQuery
• Field GetPublicNotificationTypes was added to object type RootQuery
• Field GetSecurityOperationInvestmentTypes was added to object type RootQuery
• Field GetSecurityOperationStatuses was added to object type RootQuery
• Field GetSecurityOperationTypes was added to object type RootQuery
• Field GetSecurityTypes was added to object type RootQuery
• Field GetSegmentTypes was added to object type RootQuery
• Field GetSignatureMethods was added to object type RootQuery
• Field GetSignerTypes was added to object type RootQuery
• Field GetTargetStatus was added to object type RootQuery
• Field GetTaxationTypes was added to object type RootQuery
• Field GetTransactionStates was added to object type RootQuery
• Field GetTransactionTypes was added to object type RootQuery
• Field hasSecurityOperationInvestmentScheduledSubscriptionsBareOwnership was added to object type ScpiShare
• Field hasSecurityOperationInvestmentScheduledSubscriptionsFullOwnership was added to object type ScpiShare
• Field displayOnInitialSubscription was added to object type ScpiShareDismembermentKey
• Field localizedName was added to interface SecurityFee
• Field localizedName was added to object type SecurityFeeConsultancy
• Field localizedName was added to object type SecurityFeeEntry
• Field localizedName was added to object type SecurityFeeManagement
• Field localizedName was added to object type SecurityFeePremiumSubscription
• Type SignatureInvitationResult was added
• Type SignatureLink was added
• Type SignatureMethod was added
• Type SignatureMethodDetailed was added
• Type SignerTypeDetailed was added
• Type TargetStatusDetailed was added
• Input field TransactionMoneyMovementFiltersInput.transactionMoneyMovementState description changed from Available values are: TransactionMoneyMovementState::SUCCEEDED, TransactionMoneyMovementState::CREATED, EXPORTED to Available values are: TransactionMoneyMovementState::Succeeded, TransactionMoneyMovementState::Created, Exported
• Object type TransactionMoneyMovementState has description Enum mapped from App\Enum\TransactionMoneyMovementState
• Field locale was added to interface User
• Field localeDetailed was added to interface User