Introduction

The Kompliant Web API provides a comprehensive set of methods to interact with our platform. These methods allow you to manage entities like Businesses, Persons, Bank Accounts, and Workflows throughout the compliance lifecycle.

How to Read Method Documentation

Each method page follows a consistent structure to help you understand and implement the API correctly:

  1. Method Overview: At the top of each page, you'll see a brief description in bold that explains the purpose of the method.

  2. Usage Info: This section provides context on when and why you would use this method, including common use cases and considerations.

  3. Request: Details about the required and optional parameters for the method call, including:

    • Authentication requirements
    • Parameter tables with names, types, requirements, and descriptions
    • Example request in JSON format
  4. Response: Information about what the method returns, including:

    • Data structure description
    • All possible fields and their meanings
    • Example response in JSON format
  5. Errors: Each method page includes an Errors section that highlights the most significant errors you might encounter when using that method. These typically include:

    • Method-specific validation errors
    • Entity relationship constraints
    • System rules particularly relevant to the method

      Note: Standard errors like BAD_REQUEST for malformed JSON may apply to all methods but might not be explicitly listed on every page. For a comprehensive list of all possible errors, refer to the Standard Errors documentation.

Available Methods

MethodDescription
account.documentType.listRetrieve a list of the available Document Types for the Account
bankAccount.createCreate a Bank Account entity to capture financial account details.
bankAccount.deleteRemove a Bank Account entity from a Subject Record.
bankAccount.getRetrieve comprehensive details about a specific Bank Account entity.
bankAccount.listRetrieve a comprehensive list of all Bank Account entities within a Subject Record.
bankAccount.updateUpdate a Bank Account entity to modify its financial account details.
business.addBankAccountAssociate a Bank Account entity with a specific Business entity.
business.addOwnerAssociate a Person entity as an owner of a specific Business entity.
business.createCreate a Business entity to capture essential information about a company.
business.deleteRemove a Business entity from a Subject Record.
business.getRetrieve comprehensive details about a specific Business entity.
business.getBankAccountRetrieve comprehensive details of a specific Business Bank Account entity.
business.getOwnerRetrieve comprehensive details about a specific Business Owner entity.
business.listBankAccountsRetrieve a comprehensive list of all Bank Accounts associated with a specific Business entity.
business.listOwnersRetrieve a comprehensive list of all owners associated with a specific Business entity.
business.removeBankAccountRemove the association between a Bank Account and a Business entity.
business.removeOwnerRemove an ownership relationship between a Person and a Business entity.
business.salesInfo.createCreate a Sales Information entity to capture financial account details about a Business.
business.salesInfo.deleteRemove the Sales Info entity from a Business.
business.salesInfo.getRetrieve comprehensive details about a specific Business Sales Information entity.
business.salesInfo.updateUpdate a Sales Information entity for a Business.
business.updateUpdate a Business entity to modify essential information about a company.
business.updateBankAccountUpdate a specific Business Bank Account entity.
business.updateOwnerUpdate a specific Business Owner entity.
business.addLocationAssociate a Location entity with a specific Business entity.
business.getLocationRetrieve comprehensive details about a specific Location associated with a Business entity.
business.listLocationsRetrieve a comprehensive list of all Locations associated with a specific Business entity.
business.removeLocationRemove the association between a Location and a Business entity.
document.createCreate a Document entity to store file information and metadata.
document.deleteSoft delete a Document entity from a Subject Record.
document.getRetrieve comprehensive details about a specific Document entity.
document.getDownloadGet a presigned download URL for a Document file.
document.listRetrieve a comprehensive list of all Document entities within a Subject Record.
location.createCreate a Location entity for a SubjectRecord entity.
location.getRetrieve comprehensive details of a Location entity.
location.listRetrieve a comprehensive list of all Location entities within a Subject Record.
location.updateUpdate a Location entity to modify its details.
location.deleteRemove a Location entity from a Subject Record.
location.addBankAccountAssociate a BankAccount entity with a specific Location entity.
location.getBankAccountRetrieve comprehensive details of a LocationBankAccount entity.
location.listBankAccountsRetrieve a comprehensive list of all LocationBankAccounts entities associated with location.
location.removeBankAccountRemove the association between a BankAccount and a Location entity.
mbtrust.createCreate an account provisioning entity for MBTrust.
mbtrust.executeInitiate MBTrust account provisioning execution.
mbtrust.canExecuteValidate that a MBTrust account provisioning entity has all the required information to execute provisioning operations.
mbtrust.getRetrieve details of the MBTrust account provisioning entity.
metadata.type.defineCreate a fields definition for a metadata type
metadata.createCreate a metadata entity to capture metadata type details.
metadata.updateCreate a metadata entity to capture metadata type details.
metadata.getRetrieve details of the metadata entity of a certain metadata type.
metadata.listRetrieve comprehensive list of the all metadata details entities belonging to a SubjectRecord.
metadata.links.addLink a metadata entity to a Business, Person, Bank Account or Location entity.
metadata.links.getRetrieves the Business, Person, Bank Account or Location entity ids linked to a metadata entity.
metadata.links.removeRemove a link from a metadata entity and a Business, Person, Bank Account or Location entity.
person.createCreate a Person entity to capture detailed information about an individual.
person.deleteRemove a Person entity from a Subject Record.
person.getRetrieve comprehensive details about a specific Person entity.
person.listRetrieve a comprehensive list of all Person entities within a Subject Record.
person.updateUpdate a Person entity to modify essential information about an individual.
person.issuedIdentifier.createCreate an Issued Identifier entity to associate with a Person.
person.issuedIdentifier.deleteRemove an Issued Identifier entity from a Person.
person.issuedIdentifier.getRetrieve comprehensive details about a specific Issued Identifier entity.
person.issuedIdentifier.listRetrieve a comprehensive list of all Issued Identifiers associated with a Person.
person.issuedIdentifier.updateUpdate an Issued Identifier entity within a Person.
propay.createCreate a new provisioning entity with Global Payments
propay.getReturns information about a Propay account provisioning entity
propay.canExecuteValidate that a Propay account provisioning entity has all the required information to execute provisioning operations.
propay.executeInitiate Propay account provisioning
subjectRecord.createCreate a Subject Record to serve as a container for related entity information.
subjectRecord.deleteRemove a Subject Record entity.
subjectRecord.getRetrieve comprehensive information about a specific Subject Record.
subjectRecord.listRetrieve a comprehensive list of all Subject Record entities within an account.
workflow.canCompleteCheck Workflow data against account configured required information.
workflow.completeComplete a Workflow and finalize processing.
workflow.createCreate a Workflow to enable structured processing of data in a Subject Record.
workflow.updateUpdate a Workflow of type Business Application.
workflow.deleteRemove the Workflow entity.
workflow.getRetrieve comprehensive information about a specific Workflow.
workflow.listRetrieve a comprehensive list of all Workflow entities within a Subject Record.
workflow.requiredDocument.batchAddAdd multiple required documents to a Workflow.
workflow.requiredDocument.calculateCalculate required documents for a Workflow.
workflow.requiredDocument.eventsListList events for Workflow required documents.
workflow.requiredDocument.fulfillment.batchAddAdd multiple fulfillments to required documents.
workflow.requiredDocument.fulfillment.addCommentAdd a comment to a required document fulfillment.
workflow.requiredDocument.fulfillment.deleteDelete a required document fulfillment.
workflow.requiredDocument.fulfillment.listList fulfillments for a required document.
workflow.requiredDocument.fulfillment.updateUpdate a required document fulfillment.
workflow.requiredDocument.listList required documents for a Workflow.
workflow.startUpdate a Workflow state to STARTED triggering any processes related to this specific state.
workflow.defenseDocument.generateGenerate a defense document for a completed Workflow.
workflow.defenseDocument.getDownloadGet a presigned download URL for a Workflow defense document.
workflow.defenseDocument.listRetrieve a comprehensive list of all defense documents for a Workflow.
workflow.applicationSummary.getDownloadGet a presigned download URL for a Workflow application summary.
workflow.agreement.listRetrieve a comprehensive list of all signed Agreements associated with a Workflow.
workflow.agreement.getDownloadRetrieve a download url for a signed workflow agreement.
workflow.pricing.calculateCalculate pricing for the workflow.
workflow.pricing.getRetrieve a pricing information for the workflow.
webhook.key.activateActivates a webhook key for encrypting webhook payloads.
wekhook.key.createCreates a new encryption key for securing webhook payloads.
webhook.key.getReturns information about a specific webhook key.
wekhook.config.createCreates a webhook configuration to setup receivers.
wekhook.config.updateUpdates an existing webhook configuration.
wekhook.config.listList existing webhook configurations.
wekhook.config.getGets an specific webhook configuration.
wekhook.config.deleteDeletes a webhook configuration.

Common Patterns

Our API methods follow consistent patterns that make them intuitive to use:

  • Entity Creation: Methods like create establish new entities in the system.
  • Entity Retrieval: Methods like get and list retrieve information about existing entities.
  • Entity Deletion: Methods like delete remove entities from the system.
  • Relationship Management: Methods like addOwner, removeBankAccount, etc. manage relationships between entities.

Additional Resources

For more detailed information about working with our API, refer to these resources: