Onboarding a Business Customer

This guide covers the best practice for onboarding a business customer via the Connect API. The process has two steps: screening the company and adding it to your monitoring portfolio.

Step 1: Screening the Company

Use the companyIdentifierSearch query to look up a company by its organization number and country code. This returns the company’s screening status, including PEP, sanctions, relationships, and beneficial ownership data.

query {
  companyIdentifierSearch(
    input: {
      nationalId: "123456789"
      country: NO
    }
  ) {
    id
    sanctioned
    relationships {
      edges {
        node {
          person {
            id
            name
          }
          roles {
            title
          }
          beneficialOwner
          pep {
            isPep
            pepRoles {
              role
              country
            }
          }
          sanctions {
            isSanctioned
            sanctionLists
          }
        }
      }
    }
  }
}

This query returns the company ID along with:

• Whether the company itself is sanctioned.
• All related persons (roles, beneficial owners) and their PEP and sanctions status.

Step 2: Adding to Portfolio

Once the screening is complete and the company has been reviewed, add it to your monitoring portfolio using the companyAddToMonitoring mutation:

mutation {
  companyAddToMonitoring(
    input: {
      companyId: "company-global-id"
    }
  ) {
    company {
      id
      name
      monitoringStatus
    }
  }
}

After this mutation, the company will be screened daily as part of your monitoring portfolio.

Tip: For bulk onboarding, use the companiesAddToMonitoring mutation to add multiple companies in a single API call.