LogoLogo
Home
  • Youverify API Documentation
  • Getting Started
    • Getting your API Key
    • Getting your Public Merchant Key
    • Environment
    • Response Codes
  • Know Your Customer Services (KYC)
    • ID Document Verification (SDK)
      • Web SDK
      • iOS SDK
        • iOS Liveness SDK
        • iOS (Compat) Liveness SDK
        • iOS Document Capture SDK
      • Android SDK
        • Android Document Capture SDK
        • Android Liveness SDK
      • Document Capture Supported Countries
        • 🌏Asia
        • πŸ‡ͺπŸ‡ΊEurope
        • 🌎Latin America and the Caribbean
        • 🌍Middle East and Africa
        • 🌎North America
        • 🌏Oceania
    • ID Data Matching (eIDV)
      • 🌐Global
        • Supported Countries
      • πŸ‡ΏπŸ‡¦South Africa
        • Verify South African ID Number (SAID)
        • Verify South African Phone Number
        • Bank Account Verification
        • Proof of Address Verification
      • πŸ‡°πŸ‡ͺKenya
        • Verify International Passport
        • Verify Alien ID
        • Verify Drivers License
        • Verify Plate Number
        • Verify Collateral ID
        • Kenyan Bank Account Verification
          • Bank List
        • Credit History
        • Employment History
        • Verify Address Information
        • Verify Phone Number
        • Verify Identity Number
        • Verify Tax PIN
      • πŸ‡¬πŸ‡­Ghana
        • Verify International Passport
        • Verify Social Security and National Insurance Trust (SSNIT)
        • Verify Ghana Voters Card (GVC)
      • πŸ‡³πŸ‡¬Nigeria
        • Verify Bank Verification Number (BVN)
        • Verify Bank Verification Number (BVN Premium)
        • Verify Virtual National Identification Number (vNIN)
        • Verify National Identification Number (NIN)
        • Verify Nigerian Driver's License (Driver's License)
        • Advanced Phone Search
        • Verify Nigerian International Passport (Passport)
        • Verify Nigerian Permanent Voters Card (PVC)
        • Verify Phone Number
        • Individual Credit Report
        • Bank Account Verification
          • Basic Bank Account Verification
          • Bank List
            • Getting the list of Banks for Basic Bank Account
    • Facial Comparison
    • Retrieve an Identity
    • Identity History
  • Know Your Business Services (KYB)
    • 🌍Business Verification
    • 🌍Search for Businesses
    • Get Supported Countries and Regions
    • Retrieve Business details
    • Country-Specific KYB Services
      • πŸ‡³πŸ‡¬Nigeria
        • Tax Identification Number (TIN) Verification
      • πŸ‡ΏπŸ‡¦South Africa
        • Business Account Verification
        • Business Address Verification
  • Know Your Transaction Service (KYT)
    • Customer Management
      • Create an Individual Client
      • Create a Business Client
      • Initiate an Individual Client Assessment
      • Initiate an Business Client Assessment
      • Update a Client
      • Retrieve all Clients
      • Retrieve a Client
      • Delete a Client
    • Transaction Management
      • Create a Transaction
      • Retrieve an Evaluation
  • Risk Intelligence
    • Risk Intelligence: Initialise Risk Check
    • Retrieve Risk Intelligence Profile
    • Retrieve Risk Intelligence History
  • AML Services (Anti-Money Laundering)
    • PEP and Sanction Screening
      • Search using Name
        • Advanced Filters
      • Search using Identity
        • Advanced Filters
      • Search using Crypto
        • Advanced Filters
      • Retrieve a PEP and Sanction Screening Search
      • Screening Data Sources
      • Domestic PEP Search
    • Adverse Media Intelligence
    • Custom AML Watchlist
      • AML Watchlist (Sample list)
      • AML Watchlist Upload (Bulk Upload)
      • AML Watchlist Upload
      • Retrieve AML Watchlist
      • AML Watchlist Entity Update
      • AML Watchlist Entity Removal
  • Custom Workflow Builder (CWB)
    • CWB Webhook
    • CWB External API
      • Retrieve CWB History
      • Retrieve CWB Responses
      • Retrieve CWB Report
  • Youverify OS Error Codes
  • Webhooks
    • Know Your Customer Webhooks
      • Identity Verification
      • Address Verification
    • Know Your Transaction Webhooks
      • Customer Management Webhooks
        • Client Created
        • Client Updated
      • Alert Service Webhooks
        • Alert Created
        • Alert Triage Created
        • Alert Updated
      • Evaluation Webhooks
        • Evaluation Completed
        • Evaluation Started
        • Transaction Updated
  • Test Data
  • Our Legacy API and SDK
Powered by GitBook
On this page

Was this helpful?

  1. Know Your Business Services (KYB)

Business Verification

NOTE: For Nigerian businesses, the registration number must contain the appropriate prefix and the corresponding registry number WITHOUT any space or character in between. e.g RC0000000

POST {{baseurl}}/v2/api/verifications/global/company-advance-check

Headers

Name
Type
Description

token*

String

API secret token

Request Body

Name
Type
Description

registrationNumber*

String

Registration number of business. Prefix the registration number with RC for Private companies limited by shares, BN for business name, IT for incorporated trustees, LP for limited partnership and LLP for limited liability partnerships. NOTE: For Nigerian businesses, the registration number must contain the appropriate prefix and the corresponding registration number WITHOUT any space or character in between. e.g RC0000000

registrationName

String

Registered name of the business. Provide this to refine the search, especially for older companies. Only for Nigerian companies. It will be ignored for other countries.

countryCode*

String

premium

Boolean

Perform premium checks, currently exclusive to South Africa and Kenya

isConsent*

Boolean

Indicate you have consent. Must be true

{
    "registrationNumber": "RC0000000",
    "countryCode": "NG",
    "isConsent": true
}
{
    "registrationNumber": "201133333323",
    "premium": true,
    "countryCode": "ZA",
    "isConsent": true
}
{
    "registrationNumber": "PVT-JZUA6Z663",
    "premium": true,
    "countryCode": "KE",
    "isConsent": true
}
{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "parentId": null,
        "searchBusinessName": null,
        "name": "John Doe Inc",
        "formerName": null,
        "registrationNumber": "RC00000000",
        "registryNumber": "00000000",
        "vatNumber": "00000000-0001",
        "registrationDate": "2017-06-09T00:00:00.000+00:00",
        "registrationSubmissionDate": "2017-05-31T11:22:07.713+00:00",
        "dateDisolved": null,
        "tin": "00000000-0001",
        "jtbTin": null,
        "taxOffice": null,
        "email": "johnfakedoe@gmail.com",
        "phone": "+1 000 000 0000",
        "websiteEmail": null,
        "typeOfEntity": "PRIVATE COMPANY LIMITED BY SHARES",
        "activity": "Information service activities",
        "address": "1ST FLOOR,SUM HOUSE,Fake Street",
        "state": "LAGOS",
        "lga": "Lagos Mainland",
        "city": "YABA",
        "branchAddress": "1ST FLOOR,SUM HOUSE,Fake Street, YABA, LAGOS STATE ",
        "headOfficeAddress": null,
        "objectives": "",
        "status": "found",
        "companyStatus": "ACTIVE",
        "isConsent": true,
        "lastUpdatedAt": "2022-03-30T14:19:35.571+00:00",
        "shareCapitalInWords": "TEN MILLION NAIRA",
        "paidShareCapital": "10000000",
        "subscribedShareCapital": "10000000",
        "sharesValue": "0.01 NGN",
        "activityDescription": "Information service activities",
        "sharesIssued": "10000000",
        "parentCountry": null,
        "companyContactPersons": [
            {
                "contacts": {
                    "email": [
                        "jeneki2000@yahoo.co.uk"
                    ],
                    "phone": [
                        "08034926354"
                    ]
                },
                "name": "Eboikpomwen  Eki "
            }
        ],
        "country": "Nigeria",
        "countryCode": "NG",
        "keyPersonnel": [
            {
                "name": "PETER DOE",
                "designation": "WITNESS",
                "isCorporate": false,
                "appointedOn": null,
                "resignedOn": null,
                "sharesType": "",
                "sharesValue": null,
                "sharesCount": null,
                "occupation": "LAWYER",
                "nationality": null,
                "birthYear": null,
                "birthMonth": null,
                "birthDate": null,
                "dateOfBirth": null,
                "gender": "",
                "address": "8C, NONE STREET, ZONE 4",
                "countryOfResidence": "NIGERIA",
                "number": "",
                "isForeign": "false",
                "documentType": "",
                "documentIssuedOn": null,
                "documentIssuedBy": null,
                "documentNumber": "",
                "email": "",
                "phone": "",
                "status": "ACTIVE",
                "companies": []
            },
            {
                "name": "SUSAN DOE",
                "designation": "SECRETARY_COMPANY",
                "isCorporate": false,
                "appointedOn": null,
                "resignedOn": null,
                "sharesType": "",
                "sharesValue": null,
                "sharesCount": null,
                "occupation": "SECRETARY",
                "nationality": "NIGERIA",
                "birthYear": null,
                "birthMonth": null,
                "birthDate": null,
                "dateOfBirth": null,
                "gender": "FEMALE",
                "address": "11, NONE CRESCENT",
                "countryOfResidence": "NIGERIA",
                "number": "",
                "isForeign": "false",
                "documentType": "",
                "documentIssuedOn": null,
                "documentIssuedBy": null,
                "documentNumber": "",
                "email": "",
                "phone": "",
                "status": "ACTIVE",
                "companies": []
            },
            {
                "name": "MICHAEL DOE",
                "designation": "DIRECTOR",
                "isCorporate": null,
                "appointedOn": null,
                "resignedOn": null,
                "sharesType": null,
                "sharesValue": null,
                "sharesCount": null,
                "occupation": "BUSINESS",
                "nationality": "NIGERIA",
                "birthYear": null,
                "birthMonth": null,
                "birthDate": null,
                "dateOfBirth": null,
                "gender": "MALE",
                "address": "1, NONE STREET, ",
                "countryOfResidence": "NIGERIA",
                "number": null,
                "isForeign": "false",
                "documentType": null,
                "documentIssuedOn": null,
                "documentIssuedBy": null,
                "documentNumber": null,
                "email": null,
                "phone": null,
                "status": "ACTIVE",
                "companies": []
            },
            {
                "name": "JANE DOE  INC",
                "designation": "SHAREHOLDER",
                "isCorporate": true,
                "appointedOn": "2021-03-17T14:07:43.000+00:00",
                "resignedOn": null,
                "sharesType": "ORDINARY",
                "sharesValue": "9990000",
                "sharesCount": "9990000",
                "occupation": null,
                "nationality": null,
                "birthYear": null,
                "birthMonth": null,
                "birthDate": null,
                "dateOfBirth": null,
                "gender": null,
                "address": "01 COASTAL HIGHWAY,LEWES DE 000000  USA,COUNTY OF SUSSEX",
                "countryOfResidence": "UNITED STATES",
                "number": null,
                "isForeign": "true",
                "documentType": null,
                "documentIssuedOn": null,
                "documentIssuedBy": null,
                "documentNumber": null,
                "email": null,
                "phone": null,
                "status": "ACTIVE",
                "companies": []
            },
            {
                "name": "JOHN DOE",
                "designation": "SHAREHOLDER",
                "isCorporate": null,
                "appointedOn": null,
                "resignedOn": null,
                "sharesType": "ORDINARY",
                "sharesValue": "10000",
                "sharesCount": "10000",
                "occupation": null,
                "nationality": null,
                "birthYear": null,
                "birthMonth": null,
                "birthDate": null,
                "dateOfBirth": null,
                "gender": "MALE",
                "address": "1 NONE STREET,LEKKI",
                "countryOfResidence": "NIGERIA",
                "number": null,
                "isForeign": "false",
                "documentType": null,
                "documentIssuedOn": null,
                "documentIssuedBy": null,
                "documentNumber": null,
                "email": null,
                "phone": null,
                "status": "ACTIVE",
                "companies": []
            },
            {
                "name": "JOHN DOE INC",
                "designation": "PERSONS WITH SIGNIFICANT CONTROL",
                "isCorporate": true,
                "appointedOn": "2022-03-30T14:42:16.554+00:00",
                "resignedOn": null,
                "sharesType": null,
                "sharesValue": null,
                "sharesCount": null,
                "occupation": null,
                "nationality": null,
                "birthYear": null,
                "birthMonth": null,
                "birthDate": null,
                "dateOfBirth": null,
                "gender": null,
                "address": "01 COASTAL HIGHWAY,LEWES DE 000000 ",
                "countryOfResidence": "UNITED STATES",
                "number": null,
                "isForeign": "true",
                "documentType": null,
                "documentIssuedOn": null,
                "documentIssuedBy": null,
                "documentNumber": null,
                "email": null,
                "phone": null,
                "status": "ACTIVE",
                "companies": []
            }
        ],
        "activities": [],
        "legalEntityIdentifierRegister": [
            {
                "leiCode": "0000000000000000",
                "legalName": "John Doe PLC",
                "legalAddressFirstAddressLine": "1 FAKE CRICK AVENUE",
                "legalAddressAdditionalAddressLine1": "CAMBRIDGE BIOMEDICAL CAMPUS",
                "legalAddressAdditionalAddressLine2": "",
                "legalAddressAdditionalAddressLine3": "",
                "legalAddressCity": "CAMBRIDGE",
                "legalAddressRegion": "GB-CAM",
                "legalAddressCountry": "GB",
                "legalAddressPostalCode": "CB2 0AA",
                "registrationAuthorityID": "R0000000",
                "registrationAuthorityEntityID": "00000000",
                "legalJurisdiction": "GB",
                "entityCategory": "GENERAL",
                "registrationInitialRegistrationDate": "2012-06-06",
                "registrationLastUpdateDate": "2021-08-21",
                "registrationNextRenewalDate": "2022-08-11",
                "registrationManagingLOU": "0000000000000000",
                "registrationValidationSources": "FULLY_CORROBORATED",
                "validationAuthorityID": "RA000000",
                "validationAuthorityEntityID": "02700000",
                "entityStatus": "ACTIVE",
                "status": "ISSUED"
            }
        ],
        "centralIndexKeyRegister": [
            {
                "cik": "000000",
                "entityType": "operating",
                "sic": "3711",
                "sicDescription": "Motor Vehicles & Passenger Car Bodies",
                "name": "John Doe, Inc.",
                "ein": "000000000000",
                "description": "",
                "website": "",
                "investorWebsite": "",
                "tickers": [
                    "JDL"
                ],
                "stateOfIncorporation": "DE",
                "businessAddressStreet1": "3500 FAKE STREET RD",
                "mailingAddressCity": "PALO ALTO",
                "businessAddressStreet2": null,
                "businessAddressCity": "PALO ALTO",
                "businessAddressStateOrCountry": "CA",
                "businessAddressZipCode": "123454",
                "businessAddressStateOrCountryDescription": "CA",
                "phone": "000-000-0000",
                "_id": "630ac466a4da96dee1fcae97",
                "formerNames": [
                    {
                        "from": "2005-02-17T00:00:00.000Z",
                        "to": "2017-01-27T00:00:00.000Z",
                        "name": "JDL MOTORS INC",
                        "_id": "630ac466a4da96dee1fcae98"
                    }
                ]
            }
        ],
        "filings": [
            {
                "date": "2020-10-31",
                "name": "Dissolution",
                "type": "Dissolution",
                "status": null
            },
            {
                "date": "2017-09-27",
                "name": "Incorporation",
                "type": "Incorporation",
                "status": null
            }
        ],
        "affiliates": [
            {
                "name": "John Doe 1",
                "brandName": null,
                "shortName": null,
                "companyNumber": "0000.000.000",
                "countryCode": "NG"
            },
            {
                "name": "John Doe 2",
                "brandName": null,
                "shortName": null,
                "companyNumber": "0000.000.0000",
                "countryCode": "NG"
            }
        ],
        "businessId": "62c2a4868d319373a6280152",
        "type": "advance_company_check",
        "requestedAt": "2023-05-12T08:31:33.145Z",
        "requestedById": "62c2a4868d3193700828014e",
        "searchTerm": "RC00000000",
        "createdAt": "2022-11-03T14:16:54.235Z",
        "lastModifiedAt": "2022-11-03T14:16:54.235Z",
        "_createdAt": "2022-11-03T14:16:5454+00:00",
        "_lastModifiedAt": "2022-11-03T14:16:5454+00:00",
        "id": "645df96520aa6c7da72458a0",
        "requestedBy": {
            "firstName": "API",
            "lastName": "User",
            "middleName": "",
            "id": "62c2a4868d3193700828014e"
        }
    },
    "links": []
}
HTTP/1.1 200 OK
{
        "success": true,
        "statusCode": 200,
        "message": "success",
        "data": {
            "parentId": null,
            "reason": "Company details not found",
            "name": null,
            "registrationNumber": "00000000",
            "registryNumber": null,
            "vatNumber": null,
            "registrationDate": null,
            "dateDisolved": null,
            "email": null,
            "phone": null,
            "typeOfEntity": null,
            "activity": null,
            "address": null,
            "branchAddress": null,
            "headOfficeAddress": null,
            "status": "not_found",
            "companyStatus": "Unknown",
            "isConsent": true,
            "lastUpdatedAt": null,
            "paidShareCapital": null,
            "subscribedShareCapital": null,
            "sharesValue": null,
            "activityDescription": null,
            "sharesIssued": null,
            "parentCountry": null,
            "businessId": "61d880f1e8e15aaf24558f1a",
            "type": "advance_company_check",
            "requestedAt": "2022-08-28T23:56:37.447Z",
            "requestedById": "61d880f2e8e15aaf24558f9b",
            "countryCode": "BE",
            "searchTerm": "00000000",
            "companyContactPersons": [],
            "keyPersonnel": [],
            "activities": [],
            "legalEntityIdentifierRegister": [],
            "centralIndexKeyRegister": [],
            "filings": [],
            "affiliates": [],
            "createdAt": "2022-08-28T23:56:37.668Z",
            "lastModifiedAt": "2022-08-28T23:56:37.668Z",
            "_createdAt": "2022-08-29T00:56:3737+01:00",
            "_lastModifiedAt": "2022-08-29T00:56:3737+01:00",
            "id": "630c00b3c0f18977d763855e",
            "requestedBy": {
                "firstName": "Famous",
                "lastName": "Ehichioya",
                "middleName": "Prior",
                "id": "61d880f2e8e15aaf24558f9b"
            }
        },
        "links": []
    }
HTTP/1.1 404 NotFound
{
  "success": false,
  "statusCode": 404,
  "message": "You have attempted to get a resource that does not exist.",
  "name": "ResourceNotFoundError",
  "data": {}
}
PreviousKnow Your Business Services (KYB)NextSearch for Businesses

Last updated 7 months ago

Was this helpful?

For any country with sub-divisions, always use the code of the sub-divisions and don't use the main country code.

🌍
Get company search supported countries and region