Notus API
Know your customer

Create a standard business verification session

Creates a new KYC verification session for a business. This endpoint initiates the business identity verification process by collecting company information (legal name, CNPJ, legal nature, contact details) and owners information. The session will generate upload URLs for the company proof of address document, social contract document, and owner documents (document and proof of address for each owner).

POST
/api/v1/kyc/business-verification-sessions/standard

Authorization

x-api-key<token>

In: header

Request Body

legalNamestring
emailstring
Match^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
Formatemail
documentIdstring
Match^\d+$
legalNaturestring
phoneNumberstring
Match^\d+$
website?string
Formaturi
citystring
countrystring
Value in"BRAZIL" | "AFGHANISTAN" | "ALBANIA" | "ALGERIA" | "AMERICAN_SAMOA" | "ANDORRA" | "ANGOLA" | "ANGUILLA" | "ANTARCTICA" | "ANTIGUA_AND_BARBUDA" | "ARGENTINA" | "ARMENIA" | "ARUBA" | "AUSTRALIA" | "AUSTRIA" | "AZERBAIJAN" | "BAHAMAS" | "BAHRAIN" | "BANGLADESH" | "BARBADOS" | "BELARUS" | "BELGIUM" | "BELIZE" | "BENIN" | "BERMUDA" | "BHUTAN" | "BOLIVIA" | "BONAIRE_SINT_EUSTATIUS_AND_SABA" | "BOSNIA_AND_HERZEGOVINA" | "BOTSWANA" | "BOUVET_ISLAND" | "BRITISH_INDIAN_OCEAN_TERRITORY" | "BRUNEI_DARUSSALAM" | "BULGARIA" | "BURKINA_FASO" | "BURUNDI" | "CABO_VERDE" | "CAMBODIA" | "CAMEROON" | "CANADA" | "CAYMAN_ISLANDS" | "CENTRAL_AFRICAN_REPUBLIC" | "CHAD" | "CHILE" | "CHINA" | "CHRISTMAS_ISLAND" | "COCOS_KEELING_ISLANDS" | "COLOMBIA" | "COMOROS" | "CONGO_DEMOCRATIC_REPUBLIC" | "CONGO_REPUBLIC" | "COOK_ISLANDS" | "COSTA_RICA" | "CROATIA" | "CUBA" | "CURACAO" | "CYPRUS" | "CZECH_REPUBLIC" | "COTE_DIVOIRE" | "DENMARK" | "DJIBOUTI" | "DOMINICA" | "DOMINICAN_REPUBLIC" | "ECUADOR" | "EGYPT" | "EL_SALVADOR" | "EQUATORIAL_GUINEA" | "ERITREA" | "ESTONIA" | "ESWATINI" | "ETHIOPIA" | "FALKLAND_ISLANDS" | "FAROE_ISLANDS" | "FIJI" | "FINLAND" | "FRANCE" | "FRENCH_GUIANA" | "FRENCH_POLYNESIA" | "FRENCH_SOUTHERN_TERRITORIES" | "GABON" | "GAMBIA" | "GEORGIA" | "GERMANY" | "GHANA" | "GIBRALTAR" | "GREECE" | "GREENLAND" | "GRENADA" | "GUADELOUPE" | "GUAM" | "GUATEMALA" | "GUERNSEY" | "GUINEA" | "GUINEA_BISSAU" | "GUYANA" | "HAITI" | "HEARD_ISLAND_AND_MCDONALD_ISLANDS" | "HOLY_SEE" | "HONDURAS" | "HONG_KONG" | "HUNGARY" | "ICELAND" | "INDIA" | "INDONESIA" | "IRAN" | "IRAQ" | "IRELAND" | "ISLE_OF_MAN" | "ISRAEL" | "ITALY" | "JAMAICA" | "JAPAN" | "JERSEY" | "JORDAN" | "KAZAKHSTAN" | "KENYA" | "KIRIBATI" | "NORTH_KOREA" | "SOUTH_KOREA" | "KUWAIT" | "KYRGYZSTAN" | "LAOS" | "LATVIA" | "LEBANON" | "LESOTHO" | "LIBERIA" | "LIBYA" | "LIECHTENSTEIN" | "LITHUANIA" | "LUXEMBOURG" | "MACAO" | "MADAGASCAR" | "MALAWI" | "MALAYSIA" | "MALDIVES" | "MALI" | "MALTA" | "MARSHALL_ISLANDS" | "MARTINIQUE" | "MAURITANIA" | "MAURITIUS" | "MAYOTTE" | "MEXICO" | "MICRONESIA" | "MOLDOVA" | "MONACO" | "MONGOLIA" | "MONTENEGRO" | "MONTSERRAT" | "MOROCCO" | "MOZAMBIQUE" | "MYANMAR" | "NAMIBIA" | "NAURU" | "NEPAL" | "NETHERLANDS" | "NEW_CALEDONIA" | "NEW_ZEALAND" | "NICARAGUA" | "NIGER" | "NIGERIA" | "NIUE" | "NORFOLK_ISLAND" | "NORTHERN_MARIANA_ISLANDS" | "NORWAY" | "OMAN" | "PAKISTAN" | "PALAU" | "PALESTINE" | "PANAMA" | "PAPUA_NEW_GUINEA" | "PARAGUAY" | "PERU" | "PHILIPPINES" | "PITCAIRN" | "POLAND" | "PORTUGAL" | "PUERTO_RICO" | "QATAR" | "NORTH_MACEDONIA" | "ROMANIA" | "RUSSIA" | "RWANDA" | "REUNION" | "SAINT_BARTHELEMY" | "SAINT_HELENA_ASCENSION_AND_TRISTAN_DA_CUNHA" | "SAINT_KITTS_AND_NEVIS" | "SAINT_LUCIA" | "SAINT_MARTIN" | "SAINT_PIERRE_AND_MIQUELON" | "SAINT_VINCENT_AND_THE_GRENADINES" | "SAMOA" | "SAN_MARINO" | "SAO_TOME_AND_PRINCIPE" | "SAUDI_ARABIA" | "SENEGAL" | "SERBIA" | "SEYCHELLES" | "SIERRA_LEONE" | "SINGAPORE" | "SINT_MAARTEN" | "SLOVAKIA" | "SLOVENIA" | "SOLOMON_ISLANDS" | "SOMALIA" | "SOUTH_AFRICA" | "SOUTH_GEORGIA_AND_THE_SOUTH_SANDWICH_ISLANDS" | "SOUTH_SUDAN" | "SPAIN" | "SRI_LANKA" | "SUDAN" | "SURINAME" | "SVALBARD_AND_JAN_MAYEN" | "SWEDEN" | "SWITZERLAND" | "SYRIAN_ARAB_REPUBLIC" | "TAIWAN" | "TAJIKISTAN" | "TANZANIA" | "THAILAND" | "TIMOR_LESTE" | "TOGO" | "TOKELAU" | "TONGA" | "TRINIDAD_AND_TOBAGO" | "TUNISIA" | "TURKEY" | "TURKMENISTAN" | "TURKS_AND_CAICOS_ISLANDS" | "TUVALU" | "UGANDA" | "UKRAINE" | "UNITED_ARAB_EMIRATES" | "UNITED_KINGDOM" | "UNITED_STATES_MINOR_OUTLYING_ISLANDS" | "UNITED_STATES" | "URUGUAY" | "UZBEKISTAN" | "VANUATU" | "VENEZUELA" | "VIETNAM" | "BRITISH_VIRGIN_ISLANDS" | "US_VIRGIN_ISLANDS" | "WALLIS_AND_FUTUNA" | "WESTERN_SAHARA" | "YEMEN" | "ZAMBIA" | "ZIMBABWE"
postalCodestring
statestring
streetLine1string
streetLine2?string
ownersarray<object>

Response Body

curl -X POST "https://api.notuslabs.xyz/api/v1/kyc/business-verification-sessions/standard" \  -H "Content-Type: application/json" \  -d '{    "legalName": "string",    "email": "[email protected]",    "documentId": "string",    "legalNature": "string",    "phoneNumber": "string",    "city": "string",    "country": "BRAZIL",    "postalCode": "string",    "state": "string",    "streetLine1": "string",    "owners": [      {        "firstName": "string",        "lastName": "string",        "documentId": "string",        "documentCategory": "PASSPORT",        "documentCountry": "BRAZIL",        "birthDate": "string",        "nationality": "AFGHAN",        "address": "string",        "city": "string",        "state": "string",        "postalCode": "string"      }    ]  }'
{
  "session": {
    "id": "string",
    "businessId": "string",
    "status": "PENDING",
    "legalName": "string",
    "email": "string",
    "legalNature": "string",
    "phoneNumber": "string",
    "website": "string",
    "country": "string",
    "address": "string",
    "city": "string",
    "state": "string",
    "postalCode": "string",
    "document": {
      "id": "string",
      "type": "string",
      "category": "string"
    },
    "createdAt": "string",
    "updatedAt": "string"
  },
  "proofOfAddressDocumentUpload": {
    "url": "string",
    "fields": {
      "bucket": "string",
      "X-Amz-Algorithm": "string",
      "X-Amz-Credential": "string",
      "X-Amz-Date": "string",
      "key": "string",
      "Policy": "string",
      "X-Amz-Signature": "string"
    }
  },
  "socialContractDocumentUpload": {
    "url": "string",
    "fields": {
      "bucket": "string",
      "X-Amz-Algorithm": "string",
      "X-Amz-Credential": "string",
      "X-Amz-Date": "string",
      "key": "string",
      "Policy": "string",
      "X-Amz-Signature": "string"
    }
  },
  "ownersDocuments": [
    {
      "ownerId": "string",
      "ownerDocumentId": "string",
      "frontDocumentUpload": {
        "url": "string",
        "fields": {
          "bucket": "string",
          "X-Amz-Algorithm": "string",
          "X-Amz-Credential": "string",
          "X-Amz-Date": "string",
          "key": "string",
          "Policy": "string",
          "X-Amz-Signature": "string"
        }
      },
      "backDocumentUpload": {
        "url": "string",
        "fields": {
          "bucket": "string",
          "X-Amz-Algorithm": "string",
          "X-Amz-Credential": "string",
          "X-Amz-Date": "string",
          "key": "string",
          "Policy": "string",
          "X-Amz-Signature": "string"
        }
      },
      "proofOfAddressDocumentUpload": {
        "url": "string",
        "fields": {
          "bucket": "string",
          "X-Amz-Algorithm": "string",
          "X-Amz-Credential": "string",
          "X-Amz-Date": "string",
          "key": "string",
          "Policy": "string",
          "X-Amz-Signature": "string"
        }
      }
    }
  ]
}

Create an enhanced individual verification session POST

Creates a new KYC enhanced verification session for an individual. If the individual already exists (upgrade), only enhanced documents are required. If not (direct-to-enhanced), all documents are required.

Create a standard individual verification session POST

Creates a new KYC verification session for an individual. This endpoint initiates the identity verification process by collecting personal information and document details. The session will generate upload URLs for document images and can optionally require liveness verification.