Bankei BaaS Admin
  1. KYC
Bankei BaaS Admin
  • Introduction
  • API Security and Authentication
  • Handling Monetary Values in Our System
  • Secure API Credential Exchange Process
  • Organization
    • Get Organization
      GET
  • Admin Account
    • Get Account Information
      GET
  • User
    • Create User - Basic
      POST
    • Get User
      GET
  • KYC
    • Request KYC Analisys - Company
      POST
    • Get KYC Analisys Status
      GET
    • Request KYC Analisys - Consumer
      POST
    • Send KYC Document
      POST
  • Checking Account
    • Get Account Information
      GET
    • Get Account Balance
      GET
    • Create Checking Account
      POST
    • Get Account Transactions
      GET
  • Card
    • Get Card Groups
      GET
    • Create Nominated Card
      POST
    • Get Cards
      GET
    • Get Card Shipping
      GET
    • Activate Nominated Card
      POST
    • Temporary Disable Card
      POST
    • Enable Temporary Disable Card
      POST
    • Block Card
      POST
    • Get Card Sensitive Information
      GET
  • Pix
    • Generate Pix-In Static BR Code
    • Generate Pix-In Dynamic Cob BR Code
    • Generate Pix-In Dynamic CobV BR Code
    • Get Account Pix Keys
    • Generate Pix Key
  • Pix Out
    • Preview Pix BrCode Payment
    • Preview Pix Key Payment
    • Confirm Pix Payment
  • Bill Payment
    • Line vs. Barcode
    • Bill Payment Preview
    • Create Bill Payment
  • Invoice
    • Generate Invoice
  • Receipt
    • Get Transaction Receipt
  • Webhook
    • Bill Payment Webhook Events
    • Create Webhook Subscription
    • Get Webhook Subscriptions
    • Delete Webhook Subscription
    • Get Webhook Events
    • Get Webhook Event Detail
    • Get Webhook Send Attempts
    • Get Webhook Send Attempt Detail
    • Dispatch Webhook Events
  • Sandbox
    • Pay Pix BrCode [Sandbox Only]
    • Confirm Bill Payment [Sandbox Only]
    • Reject Bill Payment [Sandbox Only]
    • Approve Kyc Analisys [Sandbox Only]
  • Schemas
    • Account
    • Asset
    • Metadata
    • Address
    • Consumer
  1. KYC

Request KYC Analisys - Company

POST
/api/kyc/analisys

Request

Authorization
Add parameter in header
x-api-key
Example:
x-api-key: ********************
Header Params

Body Params application/json

Examples

Responses

🟢200OK
application/json
Body

🟠401Unsupported signature algorithm
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://baas-api.np.bankei.com.br/api/kyc/analisys' \
--header 'x-signature: ' \
--header 'x-timestamp: ' \
--header 'x-endpoint: ' \
--header 'x-org-id: ' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "flowType": "CompanyForBankingBr",
    "countryCode": "BR",
    "userId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "personalData": {
        "company": {
            "taxId": "12345678000190",
            "companyName": "Tech Solutions LTDA",
            "mobilePhoneAreaCode": "11",
            "mobilePhoneNumber": "912345678",
            "landlineAreaCode": "11",
            "landlineNumber": "41234567",
            "email": "contato@techsolutions.com.br",
            "foundationDate": "2015-08-10T00:00:00Z",
            "annualRevenue": 2500000.00,
            "size": "EPP",
            "sector": "Services",
            "cnaeCode": "6201501",
            "primaryAddress": {
                "postalCode": "04543907",
                "city": "São Paulo",
                "neighborhood": "Itaim Bibi",
                "state": "SP",
                "streetName": "Avenida Brigadeiro Faria Lima",
                "streetNumber": "3477",
                "complement": "Sala 801"
            },
            "primaryPartner": {
                "taxId": "98765432100",
                "fullName": "João Pedro Costa",
                "mobilePhoneAreaCode": "11",
                "mobilePhoneNumber": "998877665",
                "landlineAreaCode": "11",
                "landlineNumber": "31234567",
                "email": "joao.costa@techsolutions.com.br",
                "familyIncome": 25000.00,
                "document": {
                    "type": "CNH",
                    "number": "987654321",
                    "issueDate": "2020-11-25T00:00:00Z",
                    "issuingAgency": "DETRAN",
                    "issuingState": "SP"
                },
                "birthDate": "1985-07-12T00:00:00Z",
                "birthPlaceState": "RJ",
                "birthPlaceCity": "Rio de Janeiro",
                "address": {
                    "postalCode": "05426000",
                    "city": "São Paulo",
                    "neighborhood": "Pinheiros",
                    "state": "SP",
                    "streetName": "Rua dos Pinheiros",
                    "streetNumber": "850",
                    "complement": "Casa 2"
                }
            }
        }
    },
    "termsData": {
        "version": "1.0.0",
        "accepted": true
    }
}'
Response Response Example
200 - Success
{
    "id": "019937c1-f509-777c-b763-7e0da6917e77",
    "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
    "flowType": "ConsumerForBankingBr",
    "countryCode": "BR",
    "isApproved": false,
    "steps": [
        {
            "id": "019937c1-f509-777d-8a11-4a862dbdaa46",
            "name": "AcceptTerms",
            "type": "Terms",
            "status": "SUCCESS",
            "statusReason": null,
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.1220173+00:00"
        },
        {
            "id": "019937c1-f50a-7195-8ba9-f4fa2e9ec1f0",
            "name": "Liveness",
            "type": "Liveness",
            "status": "NON-MANDATORY",
            "statusReason": "step not started, but not mandatory for this level",
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.1220197+00:00"
        },
        {
            "id": "019937c1-f50a-7196-a85a-6213f7e6be33",
            "name": "FaceMatch",
            "type": "DocumentCheck",
            "status": "PENDING",
            "statusReason": null,
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.1220202+00:00"
        },
        {
            "id": "019937c1-f50a-7197-b1d6-1b711c245128",
            "name": "IdentityDocumentFront",
            "type": "DocumentCheck",
            "status": "PENDING",
            "statusReason": null,
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.1220207+00:00"
        },
        {
            "id": "019937c1-f50a-7198-b722-d537b4d3fef6",
            "name": "IdentityDocumentBack",
            "type": "DocumentCheck",
            "status": "PENDING",
            "statusReason": null,
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.1220211+00:00"
        },
        {
            "id": "019937c1-f50a-7199-b5ce-fa38f15f07ea",
            "name": "Selfie",
            "type": "DocumentCheck",
            "status": "PENDING",
            "statusReason": null,
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.1220239+00:00"
        },
        {
            "id": "019937c1-f50a-719a-8758-f25159c29989",
            "name": "OCR",
            "type": "DocumentCheck",
            "status": "PENDING",
            "statusReason": null,
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.1220243+00:00"
        },
        {
            "id": "019937c1-f50a-719b-a84c-9576361a4c7e",
            "name": "DataRating",
            "type": "RegistrationCheck",
            "status": "SUCCESS",
            "statusReason": "automatic approval for sandbox environment",
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.1220247+00:00"
        },
        {
            "id": "019937c1-f50a-719c-8b0d-6c25b74f2b94",
            "name": "BasicInfos",
            "type": "RegistrationCheck",
            "status": "SUCCESS",
            "statusReason": "automatic approval for sandbox environment",
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.1220251+00:00"
        },
        {
            "id": "019937c1-f50a-719d-8f3a-95fec58f8588",
            "name": "FraudScore",
            "type": "FraudCheck",
            "status": "SUCCESS",
            "statusReason": "automatic approval for sandbox environment",
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.1220256+00:00"
        },
        {
            "id": "019937c1-f50a-719e-b9b1-b90402ee98df",
            "name": "ReceitaFederal",
            "type": "BackgroungCheck",
            "status": "SUCCESS",
            "statusReason": "automatic approval for sandbox environment",
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.1220259+00:00"
        },
        {
            "id": "019937c1-f50a-719f-9361-80712c1e3446",
            "name": "NationalRestrictiveLists",
            "type": "BackgroungCheck",
            "status": "SUCCESS",
            "statusReason": "automatic approval for sandbox environment",
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.1220263+00:00"
        },
        {
            "id": "019937c1-f50a-71a0-8623-8e426fbae62c",
            "name": "InternationalRestrictiveLists",
            "type": "BackgroungCheck",
            "status": "SUCCESS",
            "statusReason": "automatic approval for sandbox environment",
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.1220267+00:00"
        },
        {
            "id": "019937c1-f50a-71a1-b068-3c1c4f5ba6d6",
            "name": "ArrestWarrant",
            "type": "BackgroungCheck",
            "status": "SUCCESS",
            "statusReason": "automatic approval for sandbox environment",
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.122027+00:00"
        },
        {
            "id": "019937c1-f50a-71a2-99ec-d5d3cffb629a",
            "name": "PEP",
            "type": "BackgroungCheck",
            "status": "SUCCESS",
            "statusReason": "automatic approval for sandbox environment",
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.1220273+00:00"
        },
        {
            "id": "019937c1-f50a-71a3-a4b5-3452b882618e",
            "name": "Manual",
            "type": "ManualCheck",
            "status": "NON-MANDATORY",
            "statusReason": "step will be executed if a need for manual analysis is detected",
            "analisysId": "019937c1-f509-777c-b763-7e0da6917e77",
            "userId": "019937b1-5a71-713d-87ac-4deb590db2d5",
            "version": 1,
            "additionalData": null,
            "createdAt": "2025-09-11T07:51:22.1220277+00:00"
        }
    ],
    "createdAt": "2025-09-11T07:51:22.1219908+00:00"
}
Modified at 2026-01-12 11:51:07
Previous
Get User
Next
Get KYC Analisys Status
Built with