---
updatedAt: 2026-06-12T09:43:15.000Z
agentTools:
  projectIndex: https://docs.sumsub.com/llms.txt
---

# Automated KYB API examples

Use the [Create applicant](https://docs.sumsub.com/sumsub/reference/create-applicant) method to send the Automated KYB verification ([Automated corporate registry check](https://docs.sumsub.com/sumsub/docs/how-business-verification-works#automated-corporate-registry-check) and [Corporate AML check](https://docs.sumsub.com/sumsub/docs/how-business-verification-works#corporate-aml-screening-check)) API requests.

Depending on the [verification sources](https://docs.sumsub.com/sumsub/docs/business-verification-sources) used within Automated KYB, and in some cases, depending on the country, you have to send different `companyInfo` objects in your API calls.

# Request example

The full Automated KYB request looks as follows:

```curl
curl -X POST \
     'https://api.sumsub.com/resources/applicants?levelName=kyb-level' \
     -H 'Content-Type: application/json' \
     -H 'X-App-Token: <your-app-token>' \
     -H 'X-App-Access-Sig: <your-signature>' \
     -H 'X-App-Access-Ts: <unix-timestamp>' \
     -d '{
            "externalUserId": "someClientUserIdCompany",
            "fixedInfo": {
              "companyInfo": {
                "companyName": "Some Company",
                "registrationNumber": "12345678",
                "country": "GBR"
              }
            },
            "type": "company"
          }'
```

# Local & Regional

Here is an API example for retrieving company information when using the **Local & Regional** pack of data sources:

```json
{
  "companyName": "Some Company",
  "registrationNumber": "12345678",
  "country": "GBR"
}
```

# Advanced

Find the **Advanced** coverage API calls below. Some countries have exceptional examples, so their API calls are presented separately for each case.

> 📘 Notes
>
> * The `registrationNumber` field in the API call for Canada is an incorporation number consisting of 7 digits without letter prefixes (for example, ON, BC, A).
> * The `registrationNumber` field in the API call for the USA is a file number (also known as a corporate or business identification number), typically assigned to a business entity upon registration with the state.
> * The `address.state` field in the API call for the USA and Canada specifies a state or a province, in the two-letter format (standard postal code).

## General

```json
{
  "companyName": "Sum and Substance ltd",
  "registrationNumber": "12345678",
  "country": "GBR"
}
```

## USA

```json
{
      "companyName": "GITLAB INC.",
      "registrationNumber": "12345678",
      "country": "USA",
      "address": {
        "state": "DE",
        "country": "USA"
      }
  }
  
```

## Canada

```json
{
      "companyName": "BROOKFIELDTS GP INC.",
      "registrationNumber": "1234567",
      "country": "CAN",
      "address": {
        "state": "ON",
        "country": "CAN"
      }
  }
```

# Global

This is an API call fragment used for performing Auto KYB verification via **Global** verification sources:

```json
{
  "companyName": "Some Company",
  "registrationNumber": "HRB123456B",
  "country": "DEU"
}
```

<br />