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
x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/api/v1/kyc/business-verification-sessions/standard" \  -H "Content-Type: application/json" \  -d '{    "legalName": "string",    "email": "user@example.com",    "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.