openapi: 3.0.1 info: title: KYC API v2 version: '1.0' servers: - url: https://api-demo.knowyourcustomer.com/v2 - url: https://kycdemoapimanagementservice.azure-api.net/v2 - url: https://kycdemoapimanagementservice-uksouth-01.regional.azure-api.net/v2 paths: /verification/chinaId: post: summary: China ID Verification description: Verifies chinese individual operationId: 597b372afe9cef0db4739712 requestBody: content: application/json: example: id: 513231200001010134 name: 潮安 responses: '200': description: Success content: application/json: example: verified: true message: ID and name are consistent with police ID database '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '/companies/{caseCommonId}': get: summary: Company Details description: Gets company case details operationId: 597b372afe9cef0db473970c parameters: - name: caseCommonId in: path description: Case Common identifier required: true schema: type: number - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: "Returns company case details\r\n\r\ncommon - case common object:\r\n- caseCommonId - company case identifier in Know Your Customer web application;\r\n- caseCustomerId - identifier of the company case for related customer;\r\n- type - case common type code.\r\n- typeString - case common type name. Text representation of the type;\r\n- complete - indicates percentage of case automatic verification process completion;\r\n- edit - deprecated field;\r\n- status - current status of the company case, representing the case has been manually\r\nclosed by a user or not. Can be \"Open\" or \"Closed\";\r\n- statusId - represents current state of the case. Available status identifiers see in the table below.\r\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\r\n- isVisible - indicates if the company case is visible in Know Your Customer web\r\n- isAMLCase - indicates should we check on anti money laundering only or not;\r\n- countryRisk - anti money laundering country risk score;\r\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\r\n\r\nisCaseAMLPositive - True if the case contains at least one AML check not excluded. False otherwise\r\n\r\ncompany - case company object:\r\n- caseCompanyId - company identifier in Know Your Customer web application;\r\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\r\n- type - type of business entity;\r\n- properties - object which can contain different set of data depending from jurisdiction and registry. Each registry provides different set of data.\r\n\r\ncaseAddress - case address object:\r\n- caseAddressId - case address identifier in Know Your Customer web application;\r\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\r\n- rawAddress - address received from registry;\r\n- address - normalized address;\r\n\r\nAvailable case common status identifiers:\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n
\r\n

statusId

\r\n
\r\n

Meaning

\r\n
\r\n

Applies to what Cases

\r\n
\r\n

Description

\r\n
\r\n

0

\r\n
\r\n

Initializing

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

\"Initializing Case\" (immediately after case created)

\r\n
\r\n

1

\r\n
\r\n

Data Collection

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

Data Collection is being performed for the case (either manually or automated) the case is considerred on hold until, an automatic or manual intervention gets done

\r\n
\r\n

2

\r\n
\r\n

Data Verification

\r\n
\r\n

\r\n

Companies and Individuals

\r\n

\r\n
\r\n

The Case is being verified for Data accuracy, integrity & quality

\r\n
\r\n

3

\r\n
\r\n

Ready

\r\n
\r\n

Companies and Individuals

\r\n\r\n
\r\n

\"Ready\" (When our automatic processes are finished and all sub-cases are also ready and the user can now work on the case)

\r\n
\r\n

4-49

\r\n
\r\n

Reserved

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

-

\r\n
\r\n

50

\r\n
\r\n

RetrievingBasicData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving basic company data\" (when we get status, registered address etc.)

\r\n
\r\n

51

\r\n
\r\n

IdentifyingControllingEntities

\r\n
\r\n

Companies

\r\n
\r\n

\"Identifying controlling entities\" (when we scan for director information)

\r\n
\r\n

52

\r\n
\r\n

RetrievingExtendedData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving extended company data, if available

\r\n
\r\n

53

\r\n
\r\n

DownloadingCompanyDocuments

\r\n
\r\n

Companies

\r\n
\r\n

\"Downloading company documents\" (while documents are being downloaded and classified)

\r\n
\r\n

54

\r\n
\r\n

IdentifyingBeneficialOwners

\r\n
\r\n

Companies

\r\n
\r\n

Identifying beneficial owners\" (by using OCR, Data Extraction or Machine Learning Techniques)

\r\n
\r\n

55

\r\n
\r\n

PreparingChildren

\r\n
\r\n

Companies

\r\n
\r\n

Preparing sub-case\" (when this case is ready but some parent company shareholder or corporate secretary/director was found and we are waiting for that sub-case to finish)

\r\n
\r\n

56

\r\n
\r\n

CheckingListedEntities

\r\n
\r\n

Companies

\r\n
\r\n

Checking for market listed entities

\r\n
\r\n

57-99

\r\n
\r\n

Reserved

\r\n
\r\n

Companies

\r\n
\r\n\r\n

 

\r\n
\r\n

100

\r\n
\r\n

PerformingAmlChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual AML Checks

\r\n
\r\n

101

\r\n
\r\n

PerformingAddressChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Address Checks in available Jurisdictions

\r\n
\r\n

102

\r\n
\r\n

PerformingCourtChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Courts Data Checks in available Jurisdictions

\r\n
\r\n

103-150

\r\n
\r\n

Reserved

\r\n
\r\n

Individuals

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n" content: application/json: example: caseDetail: details: common: caseCommonId: 7839 caseCustomerId: 677 customerId: 224 customerName: YourCustomer type: 1 typeString: Company scoring: 0 complete: 55 edit: true status: Open statusChangedDatetime: statusChangedBy: statusId: 3 caseDecision: Accepted isVisible: true creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorUserName: example@example.com createdDatetime: '2017-09-26T05:22:52.8470000+00:00' updatedBySystem: '2017-09-26T05:26:11.4100000+00:00' isAMLCase: false updatedByUser: customerDepartmentId: 1249 customerDepartmentName: Management countryRisk: 5.51 assignedUserId: assignedUserName: link: https://app.knowyourcustomer.com/casecompany/7839/detail isCaseAMLPositive: true company: id: 3080 caseCompanyId: 3080 caseCommonId: 7839 countryCodeISO31662: HK entityName: HKTC Corporate Services Limited type: Private company limited by shares description: Checking for Company Situation userId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 createdDatetime: '2017-09-26T05:22:52.8930000+00:00' properties: Company Status: Active Company Type: Private company limited by shares Incorporation Date: 16/08/2012 Other Names: 香港企業諮詢服務有限公司 caseAddress: caseAddressId: 7792 caseCommonId: 7839 addressLine1: 40-44 Wyndham Place Wyndham Street Central addressLine2: '' city: Hong Kong stateProvince: postcode: country: Hong kong countryCodeISO31662: HK countryId: 3 rawAddress: '6/F., WYNDHAM PLACE,40-44 WYNDHAM STREET, CENTRAL, HONG KONG, HONG KONG' address: '40-44 Wyndham Place Wyndham Street Central, Hong Kong, Hong kong' userId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorName: example@example.com createdDatetime: '2017-09-26T05:22:52.8930000+00:00' '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/companies/{caseCommonId}/documents': get: summary: Company Documents description: Gets company documents operationId: 597b372afe9cef0db4739710 parameters: - name: caseCommonId in: path description: Case Common identifier required: true schema: type: number - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: "Returns case documents structure.\r\ndocuments - object which contains grouped documents for requested case and sub-cases (child cases).\r\nEach sub-case can contain own documents object which includes documents related to this one sub-case. Sub-cases are grouped by sections." content: application/json: example: caseCommonId: 4166 name: AUTOPOINT ACCESSORIES LIMITED documents: Company Identity Documents: - link: https://kyc.azure-api.net/v2/documents/3368 category: Certificate name: Certificate <26/01/2007> Other Company Documents: - link: https://kyc.azure-api.net/v2/documents/3369 category: COMPANY CONSTITUTION name: COMPANY CONSTITUTION <26/01/2007> - link: https://kyc.azure-api.net/v2/documents/3366 category: Company Print Out name: Company Print Out controllingEntitiesAndIndividuals: - caseCommonId: 4167 name: James Crowley documents: { } shareholdersAndBeneficialOwners: - caseCommonId: 4167 name: James Crowley documents: { } '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/companies/{caseCommonId}/members': get: summary: Company Members description: "Gets company case members. Know Your Customer application supports two types of cases:\r\n- Company case - a case created for company that should be verified;\r\n- Individual case - a case created for individual for verification against AML worldcheck database, government photo id, etc.\r\n\r\nBoth types of cases can be members of the parent company case (can be officers and/or shareholders)." operationId: 59a71a2efe9cef13f4a647f4 parameters: - name: caseCommonId in: path description: Case Common identifier required: true schema: type: number - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: "Company members structure.\r\n
\r\nAll returned member groups (controllingEntitiesAndIndividuals and shareholdersAndBeneficialOwners) can include cases for individuals and companies.\r\nEach returned member group got title which is represented by controllingEntitiesAndIndividualsTitle and shareholdersAndBeneficialOwnersTitle properties. These properties describe what kind of members the current group contains (\"Controlling Entities and Individuals\", \"Partners and Beneficial Owners\", etc).\r\n
\r\n\r\nEach member result object contains:\r\n- properties - object which can contain different set of data depending from jurisdiction and registry. Each registry provides different set of data.\r\n
Minimum dataset for company member: Company Name, Company Type,\r\n Company Registration Number, Company Status, Creation / Incorporation Date.\r\n
Minimum dataset for individual member: Individual Name, Individual Relation (Director | Secretary | Auditor | etc).\r\n\r\n- isCaseAMLPositive - True if the case contains at least one AML check not excluded. False otherwise;\r\n- isKYCed - indicates if the particular member can be processed and verified;\r\n- memberType - type of the member. Can be \"Company\" or \"Individual\".\r\n" content: application/json: example: controllingEntitiesAndIndividualsTitle: Controlling Entities and Individuals controllingEntitiesAndIndividuals: - role: Partner isCaseAMLPositive: false member: firstName: Dan lastName: Linddal Bechmann ANDERSEN caseCommonId: 14150 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 38 C Søndre Alle addressLine2: city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Søndre Alle 38 C , Rønne, 3700 Rønne, Denmark' address: '38 C Søndre Alle, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - role: Partner isCaseAMLPositive: false member: entityName: AKTK ApS caseCommonId: 14151 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 12 Store Torvegade addressLine2: '' city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Store Torvegade 12, 3700 Rønne' address: '12 Store Torvegade, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: Company Type: Private company limited by shares Company Status: Active Creation Date: 27/08/2012 Registration Number: 34692394 Other Names: ALLINGE REVISION ApS; ALLINGE REVISIONSKONTOR ApS; CENTRUM REVISION ApS memberType: Company isKYCed: true - role: Partner isCaseAMLPositive: false member: firstName: Ivan lastName: Søren QVIST caseCommonId: 14152 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 2 A Elses Løkkevej addressLine2: city: Nexø stateProvince: postcode: 3730 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Elses Løkkevej 2 A , Snogebæk, 3730 Nexø, Denmark' address: '2 A Elses Løkkevej, Nexø, 3730, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - role: Partner isCaseAMLPositive: false member: firstName: Ole lastName: BONDERUP caseCommonId: 14153 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 1 Broløkke addressLine2: city: Svaneke stateProvince: postcode: 3740 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Broløkke 1 , Østermarie, 3740 Svaneke, Denmark' address: '1 Broløkke, Svaneke, 3740, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - role: Partner isCaseAMLPositive: false member: firstName: Anders lastName: KOFOED caseCommonId: 14154 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 94 Aaker addressLine2: city: Aakirkeby stateProvince: postcode: 3720 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Søndre Landevej 94 , Aaker, 3720 Aakirkeby, Denmark' address: '94 Aaker, Aakirkeby, 3720, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - role: Partner isCaseAMLPositive: false member: firstName: Tonny lastName: KOFOED caseCommonId: 14155 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 37 Kapelvej addressLine2: city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Kapelvej 37 , Rønne, 3700 Rønne, Denmark' address: '37 Kapelvej, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - role: Director isCaseAMLPositive: false member: firstName: Dan lastName: Linddal Bechmann ANDERSEN caseCommonId: 14150 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 38 C Søndre Alle addressLine2: city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Søndre Alle 38 C , Rønne, 3700 Rønne, Denmark' address: '38 C Søndre Alle, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - role: Director isCaseAMLPositive: false member: entityName: AKTK ApS caseCommonId: 14151 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 12 Store Torvegade addressLine2: '' city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Store Torvegade 12, 3700 Rønne' address: '12 Store Torvegade, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: Company Type: Private company limited by shares Company Status: Active Creation Date: 27/08/2012 Registration Number: 34692394 Other Names: ALLINGE REVISION ApS; ALLINGE REVISIONSKONTOR ApS; CENTRUM REVISION ApS memberType: Company isKYCed: true - role: Director isCaseAMLPositive: false member: firstName: Ivan lastName: Søren QVIST caseCommonId: 14152 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 2 A Elses Løkkevej addressLine2: city: Nexø stateProvince: postcode: 3730 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Elses Løkkevej 2 A , Snogebæk, 3730 Nexø, Denmark' address: '2 A Elses Løkkevej, Nexø, 3730, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: false - role: Director isCaseAMLPositive: false member: firstName: Ole lastName: BONDERUP caseCommonId: 14153 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 1 Broløkke addressLine2: city: Svaneke stateProvince: postcode: 3740 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Broløkke 1 , Østermarie, 3740 Svaneke, Denmark' address: '1 Broløkke, Svaneke, 3740, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: false - role: Director isCaseAMLPositive: false member: firstName: Anders lastName: KOFOED caseCommonId: 14154 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 94 Aaker addressLine2: city: Aakirkeby stateProvince: postcode: 3720 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Søndre Landevej 94 , Aaker, 3720 Aakirkeby, Denmark' address: '94 Aaker, Aakirkeby, 3720, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: false - role: Director isCaseAMLPositive: false member: firstName: Tonny lastName: KOFOED caseCommonId: 14155 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 37 Kapelvej addressLine2: city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Kapelvej 37 , Rønne, 3700 Rønne, Denmark' address: '37 Kapelvej, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: false shareholdersAndBeneficialOwnersTitle: Partners and Beneficial Owners shareholdersAndBeneficialOwners: - shares: 27 isCaseAMLPositive: false member: firstName: Anders lastName: KOFOED caseCommonId: 14154 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 94 Aaker addressLine2: city: Aakirkeby stateProvince: postcode: 3720 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Søndre Landevej 94 , Aaker, 3720 Aakirkeby, Denmark' address: '94 Aaker, Aakirkeby, 3720, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - shares: 27 isCaseAMLPositive: false member: firstName: Tonny lastName: KOFOED caseCommonId: 14155 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 37 Kapelvej addressLine2: city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Kapelvej 37 , Rønne, 3700 Rønne, Denmark' address: '37 Kapelvej, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - shares: 0 isCaseAMLPositive: false member: firstName: Dan lastName: Linddal Bechmann ANDERSEN caseCommonId: 14150 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 38 C Søndre Alle addressLine2: city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Søndre Alle 38 C , Rønne, 3700 Rønne, Denmark' address: '38 C Søndre Alle, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: false - shares: 0 isCaseAMLPositive: false member: entityName: AKTK ApS caseCommonId: 14151 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 12 Store Torvegade addressLine2: '' city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Store Torvegade 12, 3700 Rønne' address: '12 Store Torvegade, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: Company Type: Private company limited by shares Company Status: Active Creation Date: 27/08/2012 Registration Number: 34692394 Other Names: ALLINGE REVISION ApS; ALLINGE REVISIONSKONTOR ApS; CENTRUM REVISION ApS memberType: Company isKYCed: false - shares: 0 isCaseAMLPositive: false member: firstName: Ivan lastName: Søren QVIST caseCommonId: 14152 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 2 A Elses Løkkevej addressLine2: city: Nexø stateProvince: postcode: 3730 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Elses Løkkevej 2 A , Snogebæk, 3730 Nexø, Denmark' address: '2 A Elses Løkkevej, Nexø, 3730, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: false - shares: 0 isCaseAMLPositive: false member: firstName: Ole lastName: BONDERUP caseCommonId: 14153 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 1 Broløkke addressLine2: city: Svaneke stateProvince: postcode: 3740 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Broløkke 1 , Østermarie, 3740 Svaneke, Denmark' address: '1 Broløkke, Svaneke, 3740, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: false '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied /companies: post: summary: Create Company Case description: Creates a new company case operationId: 597b372afe9cef0db473970f parameters: - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: "Company data.\r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n
NameDescriptionMandatory
rawnameCompany nameYes
externalCodeCompany registration numberNo
codeiso31662Country ISO 3166-2 codeYes
entityType\r\n Company type. Allowance values: Company,\r\n Partnership and Trust. (Obsolete, this parameter will be removed in the future.)\r\n Yes (for not automated jurisdictions)
journeyNameName of the journeyNo
companyType\r\n Company type. Allowance values: get from /companytypes\r\n Yes (for not automated jurisdictions)
\r\nAutomated jurisdictions. It means we are able to perform search in the registries of these particular jurisdictions. If you get response with code 400 (Bad Reqeust) and error description \"Invalid Jurisdiction\" it means the particular jurisdiction is not automated yet." content: application/json: example: codeiso31662: GB rawname: UNITED ACCESS SERVICES LIMITED entityType: Company companyType: Private company limited by shares addressLine1: Green st. addressLine2: 10 postcode: 385493 city: Garlem countryCodeiso31662: IE responses: '200': description: "Return created company case details:\r\n\r\ncommon - case common object:\r\n- caseCommonId - newly created company case identifier in Know Your Customer web application;\r\n- caseCustomerId - identifier of the company case for related customer;\r\n- type - case common type code.\r\n- typeString - case common type name. Text representation of the type. Can be \"Company\" or \"Individual\";\r\n- complete - indicates percentage of case automatic verification process completion;\r\n-edit - deprecated field;\r\n- status - current status of the company case, representing the case has been manually \r\nclosed by a user or not. Can be \"Open\" or \"Closed\";\r\n- statusId - representing current state of the case. Available status identifiers see in the table below.\r\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\r\n- isVisible - indicates if the company case is visible in Know Your Customer web \r\n- isAMLCase - indicates should we check on anti money laundering only or not;\r\n- countryRisk - anti money laundering country risk score;\r\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\r\n\r\ncompany - case company object:\r\n- caseCompanyId - company identifier in Know Your Customer web application;\r\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\r\n- type - type of business entity;\r\n- properties - object which can contain different set of data depending from jurisdiction and registry. Will be empty for this operation.\r\n\r\ncaseAddress - case address object:\r\n- caseAddressId - case address identifier in Know Your Customer web application;\r\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\r\n- rawAddress - address received from registry;\r\n- address - normalized address;\r\n\r\nAvailable case common status identifiers:\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n
\r\n

statusId

\r\n
\r\n

Meaning

\r\n
\r\n

Applies to what Cases

\r\n
\r\n

Description

\r\n
\r\n

0

\r\n
\r\n

Initializing

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

\"Initializing Case\" (immediately after case created)

\r\n
\r\n

1

\r\n
\r\n

Data Collection

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

Data Collection is being performed for the case (either manually or automated) the case is considerred on hold until, an automatic or manual intervention gets done

\r\n
\r\n

2

\r\n
\r\n

Data Verification

\r\n
\r\n

\r\n

Companies and Individuals

\r\n

\r\n
\r\n

The Case is being verified for Data accuracy, integrity & quality

\r\n
\r\n

3

\r\n
\r\n

Ready

\r\n
\r\n

Companies and Individuals

\r\n\r\n
\r\n

\"Ready\" (When our automatic processes are finished and all sub-cases are also ready and the user can now work on the case)

\r\n
\r\n

4-49

\r\n
\r\n

Reserved

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

-

\r\n
\r\n

50

\r\n
\r\n

RetrievingBasicData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving basic company data\" (when we get status, registered address etc.)

\r\n
\r\n

51

\r\n
\r\n

IdentifyingControllingEntities

\r\n
\r\n

Companies

\r\n
\r\n

\"Identifying controlling entities\" (when we scan for director information)

\r\n
\r\n

52

\r\n
\r\n

RetrievingExtendedData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving extended company data, if available

\r\n
\r\n

53

\r\n
\r\n

DownloadingCompanyDocuments

\r\n
\r\n

Companies

\r\n
\r\n

\"Downloading company documents\" (while documents are being downloaded and classified)

\r\n
\r\n

54

\r\n
\r\n

IdentifyingBeneficialOwners

\r\n
\r\n

Companies

\r\n
\r\n

Identifying beneficial owners\" (by using OCR, Data Extraction or Machine Learning Techniques)

\r\n
\r\n

55

\r\n
\r\n

PreparingChildren

\r\n
\r\n

Companies

\r\n
\r\n

Preparing sub-case\" (when this case is ready but some parent company shareholder or corporate secretary/director was found and we are waiting for that sub-case to finish)

\r\n
\r\n

56

\r\n
\r\n

CheckingListedEntities

\r\n
\r\n

Companies

\r\n
\r\n

Checking for market listed entities

\r\n
\r\n

57-99

\r\n
\r\n

Reserved

\r\n
\r\n

Companies

\r\n
\r\n\r\n

 

\r\n
\r\n

100

\r\n
\r\n

PerformingAmlChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual AML Checks

\r\n
\r\n

101

\r\n
\r\n

PerformingAddressChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Address Checks in available Jurisdictions

\r\n
\r\n

102

\r\n
\r\n

PerformingCourtChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Courts Data Checks in available Jurisdictions

\r\n
\r\n

103-150

\r\n
\r\n

Reserved

\r\n
\r\n

Individuals

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
" content: application/json: example: caseDetail: details: common: caseCommonId: 10001 caseCustomerId: 889 customerId: 224 customerName: YourCustomer type: 1 typeString: Company scoring: 0 complete: 0 edit: true status: Open statusChangedDatetime: statusChangedBy: statusId: 0 caseDecision: isVisible: true creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorUserName: example@example.com createdDatetime: '2017-10-20T21:30:53.8630000+00:00' updatedBySystem: isAMLCase: false updatedByUser: customerDepartmentId: 1249 customerDepartmentName: Management countryRisk: 4.77 assignedUserId: assignedUserName: link: https://app.knowyourcustomer.com/casecompany/10001/detail company: id: 3777 caseCompanyId: 3777 caseCommonId: 10001 countryCodeISO31662: GB entityName: TEST AIR SERVICES LTD type: description: Case Generated from API2 userId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 createdDatetime: '2017-10-20T21:30:54.0900000+00:00' properties: { } caseAddress: caseAddressId: 9950 caseCommonId: 10001 addressLine1: addressLine2: city: stateProvince: postcode: country: countryCodeISO31662: countryId: rawAddress: address: userId: creatorName: createdDatetime: '2017-10-20T21:30:54.0930000+00:00' '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Internal Error timeStamp: '2017-07-28T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied get: summary: Companies description: Gets companies list operationId: 5bdab77bbbb05c65307047e3 parameters: - name: createdDateFrom in: query description: Start time at which the case was created in ISO 8601 format (YYYY-MM-DDThh:mm:ss) schema: type: string - name: createdDateTo in: query description: End time at which the case was created in ISO 8601 format (YYYY-MM-DDThh:mm:ss) schema: type: string - name: countryCodeIso31662 in: query description: ISO 31662 country code for which the cases should belong schema: type: string - name: pageSize in: query description: Size of the page schema: type: string - name: pageNumber in: query description: Page number schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: "Return array of companies cases.\r\n\r\ncommon - case common object:\r\n- caseCommonId - company case identifier in Know Your Customer web application;\r\n- caseCustomerId - identifier of the company case for related customer;\r\n- type - case common type code.\r\n- typeString - case common type name. Text representation of the type;\r\n- complete - indicates percentage of case automatic verification process completion;\r\n- edit - deprecated field;\r\n- status - current status of the company case, representing the case has been manually\r\nclosed by a user or not. Can be \"Open\" or \"Closed\";\r\n- statusId - represents current state of the case. Available status identifiers see in the table below.\r\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\r\n- isVisible - indicates if the company case is visible in Know Your Customer web\r\n- isAMLCase - indicates should we check on anti money laundering only or not;\r\n- countryRisk - anti money laundering country risk score;\r\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\r\n\r\nisCaseAMLPositive - True if the case contains at least one AML check not excluded. False otherwise\r\n\r\ncompany - case company object:\r\n- caseCompanyId - company identifier in Know Your Customer web application;\r\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\r\n- type - type of business entity;\r\n- properties - object which can contain different set of data depending from jurisdiction and registry. Each registry provides different set of data.\r\n\r\ncaseAddress - case address object:\r\n- caseAddressId - case address identifier in Know Your Customer web application;\r\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\r\n- rawAddress - address received from registry;\r\n- address - normalized address;\r\n\r\nAvailable case common status identifiers:\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n
\r\n

statusId

\r\n
\r\n

Meaning

\r\n
\r\n

Applies to what Cases

\r\n
\r\n

Description

\r\n
\r\n

0

\r\n
\r\n

Initializing

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

\"Initializing Case\" (immediately after case created)

\r\n
\r\n

1

\r\n
\r\n

Data Collection

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

Data Collection is being performed for the case (either manually or automated) the case is considerred on hold until, an automatic or manual intervention gets done

\r\n
\r\n

2

\r\n
\r\n

Data Verification

\r\n
\r\n

\r\n

Companies and Individuals

\r\n

\r\n
\r\n

The Case is being verified for Data accuracy, integrity & quality

\r\n
\r\n

3

\r\n
\r\n

Ready

\r\n
\r\n

Companies and Individuals

\r\n\r\n
\r\n

\"Ready\" (When our automatic processes are finished and all sub-cases are also ready and the user can now work on the case)

\r\n
\r\n

4-49

\r\n
\r\n

Reserved

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

-

\r\n
\r\n

50

\r\n
\r\n

RetrievingBasicData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving basic company data\" (when we get status, registered address etc.)

\r\n
\r\n

51

\r\n
\r\n

IdentifyingControllingEntities

\r\n
\r\n

Companies

\r\n
\r\n

\"Identifying controlling entities\" (when we scan for director information)

\r\n
\r\n

52

\r\n
\r\n

RetrievingExtendedData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving extended company data, if available

\r\n
\r\n

53

\r\n
\r\n

DownloadingCompanyDocuments

\r\n
\r\n

Companies

\r\n
\r\n

\"Downloading company documents\" (while documents are being downloaded and classified)

\r\n
\r\n

54

\r\n
\r\n

IdentifyingBeneficialOwners

\r\n
\r\n

Companies

\r\n
\r\n

Identifying beneficial owners\" (by using OCR, Data Extraction or Machine Learning Techniques)

\r\n
\r\n

55

\r\n
\r\n

PreparingChildren

\r\n
\r\n

Companies

\r\n
\r\n

Preparing sub-case\" (when this case is ready but some parent company shareholder or corporate secretary/director was found and we are waiting for that sub-case to finish)

\r\n
\r\n

56

\r\n
\r\n

CheckingListedEntities

\r\n
\r\n

Companies

\r\n
\r\n

Checking for market listed entities

\r\n
\r\n

57-99

\r\n
\r\n

Reserved

\r\n
\r\n

Companies

\r\n
\r\n\r\n

 

\r\n
\r\n

100

\r\n
\r\n

PerformingAmlChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual AML Checks

\r\n
\r\n

101

\r\n
\r\n

PerformingAddressChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Address Checks in available Jurisdictions

\r\n
\r\n

102

\r\n
\r\n

PerformingCourtChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Courts Data Checks in available Jurisdictions

\r\n
\r\n

103-150

\r\n
\r\n

Reserved

\r\n
\r\n

Individuals

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n" content: application/json: example: - common: caseCommonId: 7839 caseCustomerId: 677 customerId: 224 customerName: YourCustomer type: 1 typeString: Company scoring: 0 complete: 55 edit: true status: Open statusChangedDatetime: statusChangedBy: statusId: 3 caseDecision: Accepted isVisible: true creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorUserName: example@example.com createdDatetime: '2017-09-26T05:22:52.8470000+00:00' updatedBySystem: '2017-09-26T05:26:11.4100000+00:00' isAMLCase: false updatedByUser: customerDepartmentId: 1249 customerDepartmentName: Management countryRisk: 5.51 assignedUserId: assignedUserName: link: https://app.knowyourcustomer.com/casecompany/7839/detail isCaseAMLPositive: true company: id: 3080 caseCompanyId: 3080 caseCommonId: 7839 countryCodeISO31662: HK entityName: HKTC Corporate Services Limited type: Private company limited by shares description: Checking for Company Situation userId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 createdDatetime: '2017-09-26T05:22:52.8930000+00:00' properties: Company Status: Active Company Type: Private company limited by shares Incorporation Date: 16/08/2012 Other Names: 香港企業諮詢服務有限公司 caseAddress: caseAddressId: 7792 caseCommonId: 7839 addressLine1: 40-44 Wyndham Place Wyndham Street Central addressLine2: '' city: Hong Kong stateProvince: postcode: country: Hong kong countryCodeISO31662: HK countryId: 3 rawAddress: '6/F., WYNDHAM PLACE,40-44 WYNDHAM STREET, CENTRAL, HONG KONG, HONG KONG' address: '40-44 Wyndham Place Wyndham Street Central, Hong Kong, Hong kong' userId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorName: example@example.com createdDatetime: '2017-09-26T05:22:52.8930000+00:00' '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/documents/{documentId}': get: summary: Download Document description: Download Document operationId: 597b372afe9cef0db4739711 parameters: - name: documentId in: path description: Document id required: true schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: Document data content: application/json: { } '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. /jurisdictions: get: summary: Jurisdictions description: Get available jurisdictions operationId: 597b372afe9cef0db473970e parameters: - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: Returns list of the available jurisdictions content: application/json: example: jurisdictions: jurisdiction: - name: Ireland codeiso31662: IE area: Europe isautomated: true - name: United kingdom codeiso31662: GB area: Europe isautomated: true - name: Czech republic codeiso31662: CZ area: Europe isautomated: false '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid API Key timeStamp: '2017-07-28T14:15:51.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied /companies/search: post: summary: Search Companies description: "Executes companies search in the registry of the specified jurisdiciton based on:\r\n- country code defined in ISO 3166-2 standard;\r\n- search query (full or partial company name or company registration number).\r\n\r\nCompanies search working only for automated jurisdictions. It means we are able to perform search in the registries of these particular jurisdictions. If you get response with code 400 (Bad Reqeust) and error description \"Invalid Jurisdiction\" it means the particular jurisdiction is not automated yet." operationId: 597b372afe9cef0db473970d parameters: - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: "Parameters definition:\r\n- codeiso31662 - jurisdiction's country code defined in ISO 3166-2 standard;\r\n- query - full or partial name or registration number of the company you are looking for." content: application/json: example: codeiso31662: GB query: Test responses: '200': description: "Returns companies list based on search criteria:\r\n- rawname - actual company name or trade name provided by registry site;\r\n- externalCode - company registration number provided by registry site;\r\n- rawAddress - company address provided by registry site." content: application/json: example: companySearch: results: - rawname: TEST AIR SERVICES LTD externalCode: 6650586 rawAddress: '96 96 Pelhurst Road, Ryde, Isle Of Wight, England' - rawname: TEST AIR SOLUTIONS LIMITED externalCode: 5661420 rawAddress: '225 Market Street, Hyde, Cheshire, SK14 1HF' '400': description: "Invalid request parameters. Errors descriptions:\r\n- Invalid Jurisdiction - provided jurisdiction is not automated yet. You cannot perform companies search for not automated jurisdictions." content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid Jurisdiction timeStamp: '2017-07-25T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied /verification/identity: post: summary: Verify Identity description: "Verifies uploaded passport document without performing First Name / Last Name / Birth Date comparison and returns a verification report.\r\n\r\nFinal verification result can be accessed from success or triggeredRule property. Properties are described in the response schema." operationId: 597b372afe9cef0db4739713 parameters: - name: ApiKey in: header description: '' required: true schema: type: string requestBody: content: multipart/form-data: schema: properties: file: type: string description: Passport image responses: '200': description: Identity verification result content: application/json: example: success: false message: triggeredRule: scenario: '#8' result: Fail message: DocumentIsExpired sensitivity: Low decision: Expired properties: failUpload: false imageQuality: percentage: 71 value: High forgeryTests: - group: Data Integrity type: Check Sum - Date of Birth result: Authenticated - group: Data Integrity type: Check Sum - Date of Expiry result: Authenticated - group: Data Integrity type: Check Sum - Document Number result: Authenticated - group: Data Integrity type: Check Sum - General result: Authenticated - group: Data Integrity type: Check Sum - Optional Data result: Authenticated - group: Data Integrity type: Data Comparison - Date of Birth result: NotRelevant - group: Data Integrity type: Data Comparison - Expiry Date result: NotRelevant - group: Data Integrity type: Data Comparison - Last Name result: Unconclusive - group: Data Integrity type: Validation - MRZ Date of Birth result: Authenticated - group: Data Integrity type: Validation - MRZ Date of Expiry result: Authenticated - group: Digital type: Photo Replacement result: Authenticated - group: Digital type: Text Replacement result: NotRelevant - group: Structure type: Complete MRZ result: Authenticated - group: Structure type: MRZ Fonts - Alphabetic result: NotRelevant - group: Structure type: MRZ Fonts - Digits result: Authenticated identityReport: firstName: KEVIN RICHARD lastName: HALLIGEN birthDate: '1961-07-14T00:00:00.0000000+00:00' sourceDocument: Passport birthPlace: expiryDate: '2012-02-13T00:00:00.0000000+00:00' documentNumber: S196082 address: '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid API Key timeStamp: '2017-07-28T14:15:51.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied /version: get: summary: Version description: Get current API version. operationId: 597b3729fe9cef0db473970b parameters: - name: ApiKey in: header required: true schema: type: string responses: '200': description: Success content: application/json: example: 2.0.1.23013 '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. /individuals: post: summary: Create Individual Case description: Creates a new individual case operationId: 5a181acf1257bc13c421bd17 parameters: - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: "Individual data.\r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n \r\n
NameDescriptionMandatory
firstNameThe First NameYes
lastNameThe Family NameYes
nationalityCodeiso31662Nationality Country ISO 3166-2 codeNo
birthDateThe Date of Birth (Format: dd/mm/yyyy)No
addressLine1Address Line 1No
addressLine2Address Line 2No
postcodeThe postcodeNo
cityThe cityNo
provinceThe state/provinceNo
countryCodeiso31662Address Country ISO 3166-2 codeNo
propertiesArray of the individual properties, has same request body structure as described at the POST /individuals/caseCommonId/properties endpointNo
journeyNameName of the jounrneyNo
" content: application/json: example: firstName: John lastName: Doe nationalityCodeiso31662: GB birthDate: '1980-01-01T00:00:00.0000000+00:00' addressLine1: addressLine2: postcode: city: province: countryCodeiso31662: properties: - dataType: BirthDate data: '1990-01-01T00:00:00.0000000+00:00' journeyName: All responses: '200': description: "Return created individual case details:\r\n\r\ncommon - case common object:\r\n- caseCommonId - individual case identifier in Know Your Customer web application;\r\n- caseCustomerId - identifier of the individual case for related customer;\r\n- type - case common type code.\r\n- typeString - case common type name. Text representation of the type;\r\n- complete - indicates percentage of case automatic verification process completion;\r\n- edit - deprecated field;\r\n- status - current status of the individual case, representing the case has been manually \r\nclosed by a user or not. Can be \"Open\" or \"Closed\";\r\n- statusId - representing current state of the case. Available status identifiers see in the table below.\r\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\r\n- isVisible - indicates if the individual case is visible in Know Your Customer web \r\n- isAMLCase - indicates should we check on anti money laundering only or not;\r\n- countryRisk - anti money laundering country risk score;\r\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\r\n\r\nindividual - case individual object:\r\n- caseIndividualId - individual identifier in Know Your Customer web application;\r\n- firstName - individual's first name;\r\n- lastName - individual's last name;\r\n- countryCodeISO31662 - country code of individual case defined in ISO 3166-2 standard;\r\n- nationalityCodeISO31662 - country code of the nationality defined in ISO 3166-2 standard;\r\n- properties - object which can contain different set of data like Date of Birth, Occupdation, etc;\r\n\r\ncaseAddress - case address object:\r\n- caseAddressId - case address identifier in Know Your Customer web application;\r\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\r\n- rawAddress - address received from registry;\r\n- address - normalized address;\r\n\r\nAvailable case common status identifiers:\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n
\r\n

statusId

\r\n
\r\n

Meaning

\r\n
\r\n

Applies to what Cases

\r\n
\r\n

Description

\r\n
\r\n

0

\r\n
\r\n

Initializing

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

\"Initializing Case\" (immediately after case created)

\r\n
\r\n

1

\r\n
\r\n

Data Collection

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

Data Collection is being performed for the case (either manually or automated) the case is considerred on hold until, an automatic or manual intervention gets done

\r\n
\r\n

2

\r\n
\r\n

Data Verification

\r\n
\r\n

\r\n

Companies and Individuals

\r\n

\r\n
\r\n

The Case is being verified for Data accuracy, integrity & quality

\r\n
\r\n

3

\r\n
\r\n

Ready

\r\n
\r\n

Companies and Individuals

\r\n\r\n
\r\n

\"Ready\" (When our automatic processes are finished and all sub-cases are also ready and the user can now work on the case)

\r\n
\r\n

4-49

\r\n
\r\n

Reserved

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

-

\r\n
\r\n

50

\r\n
\r\n

RetrievingBasicData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving basic company data\" (when we get status, registered address etc.)

\r\n
\r\n

51

\r\n
\r\n

IdentifyingControllingEntities

\r\n
\r\n

Companies

\r\n
\r\n

\"Identifying controlling entities\" (when we scan for director information)

\r\n
\r\n

52

\r\n
\r\n

RetrievingExtendedData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving extended company data, if available

\r\n
\r\n

53

\r\n
\r\n

DownloadingCompanyDocuments

\r\n
\r\n

Companies

\r\n
\r\n

\"Downloading company documents\" (while documents are being downloaded and classified)

\r\n
\r\n

54

\r\n
\r\n

IdentifyingBeneficialOwners

\r\n
\r\n

Companies

\r\n
\r\n

Identifying beneficial owners\" (by using OCR, Data Extraction or Machine Learning Techniques)

\r\n
\r\n

55

\r\n
\r\n

PreparingChildren

\r\n
\r\n

Companies

\r\n
\r\n

Preparing sub-case\" (when this case is ready but some parent company shareholder or corporate secretary/director was found and we are waiting for that sub-case to finish)

\r\n
\r\n

56

\r\n
\r\n

CheckingListedEntities

\r\n
\r\n

Companies

\r\n
\r\n

Checking for market listed entities

\r\n
\r\n

57-99

\r\n
\r\n

Reserved

\r\n
\r\n

Companies

\r\n
\r\n\r\n

 

\r\n
\r\n

100

\r\n
\r\n

PerformingAmlChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual AML Checks

\r\n
\r\n

101

\r\n
\r\n

PerformingAddressChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Address Checks in available Jurisdictions

\r\n
\r\n

102

\r\n
\r\n

PerformingCourtChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Courts Data Checks in available Jurisdictions

\r\n
\r\n

103-150

\r\n
\r\n

Reserved

\r\n
\r\n

Individuals

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
" content: application/json: example: caseDetail: details: individual: caseIndividualId: 8905 firstName: John lastName: Doe countryCodeISO31662: PT country: Portugal email: phone: nationalityCountryCodeISO31662: GB nationalityCountry: United kingdom caseCommonId: 14050 creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 properties: Birth Date: '1990-01-01T00:00:00.0000000+00:00' createdDatetime: '2017-11-24T11:44:17.2200000+00:00' common: caseCommonId: 14069 caseCustomerId: 1165 customerId: 224 customerName: AndreiCo type: 2 typeString: Individual scoring: 0 complete: 0 edit: true status: Open statusChangedDatetime: statusChangedBy: statusId: caseDecision: isVisible: true creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorUserName: avgybarev@gmail.com createdDatetime: '2017-11-24T13:41:58.0300000+00:00' updatedBySystem: isAMLCase: updatedByUser: customerDepartmentId: 1249 customerDepartmentName: Management countryRisk: 4.77 assignedUserId: assignedUserName: link: https://dev.knowyourcustomer.com/caseindividual/14069/detail caseAddress: caseAddressId: 7792 caseCommonId: 7839 addressLine1: 40-44 Wyndham Place Wyndham Street Central addressLine2: '' city: Hong Kong stateProvince: postcode: country: Hong kong countryCodeISO31662: HK countryId: 3 rawAddress: '6/F., WYNDHAM PLACE,40-44 WYNDHAM STREET, CENTRAL, HONG KONG, HONG KONG' address: '40-44 Wyndham Place Wyndham Street Central, Hong Kong, Hong kong' userId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorName: example@example.com createdDatetime: '2017-09-26T05:22:52.8930000+00:00' '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Internal Error timeStamp: '2017-07-28T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied get: summary: Individuals description: Gets individuals list operationId: 5bdacf5a13f9403fd9df848b parameters: - name: createdDateFrom in: query description: Start time at which the case was created in ISO 8601 format (YYYY-MM-DDThh:mm:ss) schema: type: string - name: createdDateTo in: query description: End time at which the case was created in ISO 8601 format (YYYY-MM-DDThh:mm:ss) schema: type: string - name: countryCodeIso31662 in: query description: ISO 31662 country code for which the cases should belong schema: type: string - name: pageSize in: query description: Size of the page schema: type: string - name: pageNumber in: query description: Page number schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: "Returns list of individual cases.\r\n\r\ncommon - case common object:\r\n- caseCommonId - individual case identifier in Know Your Customer web application;\r\n- caseCustomerId - identifier of the individual case for related customer;\r\n- type - case common type code.\r\n- typeString - case common type name. Text representation of the type;\r\n- complete - indicates percentage of case automatic verification process completion;\r\n- edit - deprecated field;\r\n- status - current status of the individual case, representing the case has been manually \r\nclosed by a user or not. Can be \"Open\" or \"Closed\";\r\n- statusId - representing current state of the case. Available status identifiers see in the table below.\r\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\r\n- isVisible - indicates if the individual case is visible in Know Your Customer web \r\n- isAMLCase - indicates should we check on anti money laundering only or not;\r\n- countryRisk - anti money laundering country risk score;\r\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\r\n\r\nisCaseAMLPositive - True if the case contains at least one AML check not excluded. False otherwise\r\n\r\nindividual - case individual object:\r\n- caseIndividualId - individual identifier in Know Your Customer web application;\r\n- firstName - individual's first name;\r\n- lastName - individual's last name;\r\n- countryCodeISO31662 - country code of individual case defined in ISO 3166-2 standard;\r\n- nationalityCodeISO31662 - country code of the nationality defined in ISO 3166-2 standard;\r\n- properties - object which can contain different set of data like Date of Birth, Occupdation, etc;\r\n\r\ncaseAddress - case address object:\r\n- caseAddressId - case address identifier in Know Your Customer web application;\r\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\r\n- rawAddress - address received from registry;\r\n- address - normalized address;\r\n\r\nAvailable case common status identifiers:\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n
\r\n

statusId

\r\n
\r\n

Meaning

\r\n
\r\n

Applies to what Cases

\r\n
\r\n

Description

\r\n
\r\n

0

\r\n
\r\n

Initializing

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

\"Initializing Case\" (immediately after case created)

\r\n
\r\n

1

\r\n
\r\n

Data Collection

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

Data Collection is being performed for the case (either manually or automated) the case is considerred on hold until, an automatic or manual intervention gets done

\r\n
\r\n

2

\r\n
\r\n

Data Verification

\r\n
\r\n

\r\n

Companies and Individuals

\r\n

\r\n
\r\n

The Case is being verified for Data accuracy, integrity & quality

\r\n
\r\n

3

\r\n
\r\n

Ready

\r\n
\r\n

Companies and Individuals

\r\n\r\n
\r\n

\"Ready\" (When our automatic processes are finished and all sub-cases are also ready and the user can now work on the case)

\r\n
\r\n

4-49

\r\n
\r\n

Reserved

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

-

\r\n
\r\n

50

\r\n
\r\n

RetrievingBasicData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving basic company data\" (when we get status, registered address etc.)

\r\n
\r\n

51

\r\n
\r\n

IdentifyingControllingEntities

\r\n
\r\n

Companies

\r\n
\r\n

\"Identifying controlling entities\" (when we scan for director information)

\r\n
\r\n

52

\r\n
\r\n

RetrievingExtendedData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving extended company data, if available

\r\n
\r\n

53

\r\n
\r\n

DownloadingCompanyDocuments

\r\n
\r\n

Companies

\r\n
\r\n

\"Downloading company documents\" (while documents are being downloaded and classified)

\r\n
\r\n

54

\r\n
\r\n

IdentifyingBeneficialOwners

\r\n
\r\n

Companies

\r\n
\r\n

Identifying beneficial owners\" (by using OCR, Data Extraction or Machine Learning Techniques)

\r\n
\r\n

55

\r\n
\r\n

PreparingChildren

\r\n
\r\n

Companies

\r\n
\r\n

Preparing sub-case\" (when this case is ready but some parent company shareholder or corporate secretary/director was found and we are waiting for that sub-case to finish)

\r\n
\r\n

56

\r\n
\r\n

CheckingListedEntities

\r\n
\r\n

Companies

\r\n
\r\n

Checking for market listed entities

\r\n
\r\n

57-99

\r\n
\r\n

Reserved

\r\n
\r\n

Companies

\r\n
\r\n\r\n

 

\r\n
\r\n

100

\r\n
\r\n

PerformingAmlChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual AML Checks

\r\n
\r\n

101

\r\n
\r\n

PerformingAddressChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Address Checks in available Jurisdictions

\r\n
\r\n

102

\r\n
\r\n

PerformingCourtChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Courts Data Checks in available Jurisdictions

\r\n
\r\n

103-150

\r\n
\r\n

Reserved

\r\n
\r\n

Individuals

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
" content: application/json: example: - individual: caseIndividualId: 8905 firstName: John lastName: Doe countryCodeISO31662: PT country: Portugal email: phone: nationalityCountryCodeISO31662: GB nationalityCountry: United kingdom caseCommonId: 14050 creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 properties: Birth Date: '1990-01-01T00:00:00.0000000+00:00' createdDatetime: '2017-11-24T11:44:17.2200000+00:00' isCaseAMLPositive: true common: caseCommonId: 14069 caseCustomerId: 1165 customerId: 224 customerName: AndreiCo type: 2 typeString: Individual scoring: 0 complete: 0 edit: true status: Open statusChangedDatetime: statusChangedBy: statusId: caseDecision: Accepted isVisible: true creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorUserName: avgybarev@gmail.com createdDatetime: '2017-11-24T13:41:58.0300000+00:00' updatedBySystem: isAMLCase: updatedByUser: customerDepartmentId: 1249 customerDepartmentName: Management countryRisk: 4.77 assignedUserId: assignedUserName: link: https://dev.knowyourcustomer.com/caseindividual/14069/detail caseAddress: caseAddressId: 7792 caseCommonId: 7839 addressLine1: 40-44 Wyndham Place Wyndham Street Central addressLine2: '' city: Hong Kong stateProvince: postcode: country: Hong kong countryCodeISO31662: HK countryId: 3 rawAddress: '6/F., WYNDHAM PLACE,40-44 WYNDHAM STREET, CENTRAL, HONG KONG, HONG KONG' address: '40-44 Wyndham Place Wyndham Street Central, Hong Kong, Hong kong' userId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorName: example@example.com createdDatetime: '2017-09-26T05:22:52.8930000+00:00' '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/individuals/{caseCommonId}': get: summary: Individual Details description: Gets individual case details operationId: 5a180a231257bc13c421bd16 parameters: - name: caseCommonId in: path description: Case Common identifier required: true schema: type: number - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: "Returns individual case details\r\n\r\ncommon - case common object:\r\n- caseCommonId - individual case identifier in Know Your Customer web application;\r\n- caseCustomerId - identifier of the individual case for related customer;\r\n- type - case common type code.\r\n- typeString - case common type name. Text representation of the type;\r\n- complete - indicates percentage of case automatic verification process completion;\r\n- edit - deprecated field;\r\n- status - current status of the individual case, representing the case has been manually\r\nclosed by a user or not. Can be \"Open\" or \"Closed\";\r\n- statusId - representing current state of the case. Available status identifiers see in the table below.\r\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\r\n- isVisible - indicates if the individual case is visible in Know Your Customer web\r\n- isAMLCase - indicates should we check on anti money laundering only or not;\r\n- countryRisk - anti money laundering country risk score;\r\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\r\n\r\nisCaseAMLPositive - True if the case contains at least one AML check not excluded. False otherwise\r\n\r\nindividual - case individual object:\r\n- caseIndividualId - individual identifier in Know Your Customer web application;\r\n- firstName - individual's first name;\r\n- lastName - individual's last name;\r\n- countryCodeISO31662 - country code of individual case defined in ISO 3166-2 standard;\r\n- nationalityCodeISO31662 - country code of the nationality defined in ISO 3166-2 standard;\r\n- properties - object which can contain different set of data like Date of Birth, Occupdation, etc;\r\n\r\ncaseAddress - case address object:\r\n- caseAddressId - case address identifier in Know Your Customer web application;\r\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\r\n- rawAddress - address received from registry;\r\n- address - normalized address;\r\n\r\nAvailable case common status identifiers:\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n
\r\n

statusId

\r\n
\r\n

Meaning

\r\n
\r\n

Applies to what Cases

\r\n
\r\n

Description

\r\n
\r\n

0

\r\n
\r\n

Initializing

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

\"Initializing Case\" (immediately after case created)

\r\n
\r\n

1

\r\n
\r\n

Data Collection

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

Data Collection is being performed for the case (either manually or automated) the case is considerred on hold until, an automatic or manual intervention gets done

\r\n
\r\n

2

\r\n
\r\n

Data Verification

\r\n
\r\n

\r\n

Companies and Individuals

\r\n

\r\n
\r\n

The Case is being verified for Data accuracy, integrity & quality

\r\n
\r\n

3

\r\n
\r\n

Ready

\r\n
\r\n

Companies and Individuals

\r\n\r\n
\r\n

\"Ready\" (When our automatic processes are finished and all sub-cases are also ready and the user can now work on the case)

\r\n
\r\n

4-49

\r\n
\r\n

Reserved

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

-

\r\n
\r\n

50

\r\n
\r\n

RetrievingBasicData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving basic company data\" (when we get status, registered address etc.)

\r\n
\r\n

51

\r\n
\r\n

IdentifyingControllingEntities

\r\n
\r\n

Companies

\r\n
\r\n

\"Identifying controlling entities\" (when we scan for director information)

\r\n
\r\n

52

\r\n
\r\n

RetrievingExtendedData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving extended company data, if available

\r\n
\r\n

53

\r\n
\r\n

DownloadingCompanyDocuments

\r\n
\r\n

Companies

\r\n
\r\n

\"Downloading company documents\" (while documents are being downloaded and classified)

\r\n
\r\n

54

\r\n
\r\n

IdentifyingBeneficialOwners

\r\n
\r\n

Companies

\r\n
\r\n

Identifying beneficial owners\" (by using OCR, Data Extraction or Machine Learning Techniques)

\r\n
\r\n

55

\r\n
\r\n

PreparingChildren

\r\n
\r\n

Companies

\r\n
\r\n

Preparing sub-case\" (when this case is ready but some parent company shareholder or corporate secretary/director was found and we are waiting for that sub-case to finish)

\r\n
\r\n

56

\r\n
\r\n

CheckingListedEntities

\r\n
\r\n

Companies

\r\n
\r\n

Checking for market listed entities

\r\n
\r\n

57-99

\r\n
\r\n

Reserved

\r\n
\r\n

Companies

\r\n
\r\n\r\n

 

\r\n
\r\n

100

\r\n
\r\n

PerformingAmlChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual AML Checks

\r\n
\r\n

101

\r\n
\r\n

PerformingAddressChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Address Checks in available Jurisdictions

\r\n
\r\n

102

\r\n
\r\n

PerformingCourtChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Courts Data Checks in available Jurisdictions

\r\n
\r\n

103-150

\r\n
\r\n

Reserved

\r\n
\r\n

Individuals

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n" content: application/json: example: caseDetail: details: individual: caseIndividualId: 8905 firstName: John lastName: Doe countryCodeISO31662: PT country: Portugal email: phone: nationalityCountryCodeISO31662: GB nationalityCountry: United kingdom caseCommonId: 14050 creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 properties: Birth Date: '1990-01-01T00:00:00.0000000+00:00' createdDatetime: '2017-11-24T11:44:17.2200000+00:00' isCaseAMLPositive: true common: caseCommonId: 14069 caseCustomerId: 1165 customerId: 224 customerName: AndreiCo type: 2 typeString: Individual scoring: 0 complete: 0 edit: true status: Open statusChangedDatetime: statusChangedBy: statusId: caseDecision: Accepted isVisible: true creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorUserName: avgybarev@gmail.com createdDatetime: '2017-11-24T13:41:58.0300000+00:00' updatedBySystem: isAMLCase: updatedByUser: customerDepartmentId: 1249 customerDepartmentName: Management countryRisk: 4.77 assignedUserId: assignedUserName: link: https://dev.knowyourcustomer.com/caseindividual/14069/detail caseAddress: caseAddressId: 7792 caseCommonId: 7839 addressLine1: 40-44 Wyndham Place Wyndham Street Central addressLine2: '' city: Hong Kong stateProvince: postcode: country: Hong kong countryCodeISO31662: HK countryId: 3 rawAddress: '6/F., WYNDHAM PLACE,40-44 WYNDHAM STREET, CENTRAL, HONG KONG, HONG KONG' address: '40-44 Wyndham Place Wyndham Street Central, Hong Kong, Hong kong' userId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorName: example@example.com createdDatetime: '2017-09-26T05:22:52.8930000+00:00' '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/companies/{caseCommonId}/properties': post: summary: Create/Update Company Case Properties description: Creates new company case properties or update existing with same data type and returns array of existing company case properties operationId: 5a421c561257bc0ca8459627 parameters: - name: caseCommonId in: path description: '' required: true schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: "Body should contain array of case properties you want to create/update. Case property object contains:\r\n- dataType - case property data type;\r\n- data - case property data.\r\n\r\nYou can create case property with data type existing in the system or new one.\r\n\r\nNote: Please call /properties/dataTypes to get existing data types and reuse them. If you can't find proper data type in existing data types then create case property with new one data type." content: application/json: example: - dataType: Activity Type data: Any type - dataType: Other Names data: Test Limited responses: '200': description: Return all case properties for particular company case. content: application/json: example: - dataType: Activity Type data: Any type - dataType: Other Names data: Test Limited '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-28T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied get: summary: Get Company Case Properties description: Gets company case properties operationId: 5a4219cf1257bc0ca8459625 parameters: - name: caseCommonId in: path description: '' required: true schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: Returns array of company case properties. content: application/json: example: - dataType: Other Names data: Test Company Limited '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/individuals/{caseCommonId}/properties': post: summary: Create/Update Individual Case Properties description: Creates new individual case properties or update existing with same data type and returns array of existing individual case properties operationId: 5a4220901257bc0ca8459628 parameters: - name: caseCommonId in: path description: '' required: true schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: "Body should contain array of case properties you want to create/update. Case property object contains:\r\n- dataType - case property data type;\r\n- data - case property data.\r\n\r\nYou can create case property with data type existing in the system or new one.\r\n\r\nNote: Please call /properties/dataTypes to get existing data types and reuse them. If you can't find proper data type in existing data types then create case property with new one data type." content: application/json: example: - dataType: Birth Date data: '1990-01-01T00:00:00.0000000+00:00' responses: '200': description: Return all case properties for particular individual case. content: application/json: example: - dataType: Birth Date data: '2000-01-01T00:00:00.0000000+00:00' '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-28T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied get: summary: Get Individual Case Properties description: Gets individual case properties operationId: 5a421b361257bc0ca8459626 parameters: - name: caseCommonId in: path description: '' required: true schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: Returns array of individual case properties. content: application/json: example: - dataType: Birth Date data: '2000-01-01T00:00:00.0000000+00:00' '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied /properties/dataTypes: get: summary: Get Data Types description: Gets distinct data types of case properties existing in the system. operationId: 5a4215061257bc0ca8459623 parameters: - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: Return distinct datatypes of case properties existing in the system that could be used to create new properties records. content: application/json: example: - Birth Date - Nationality - Creation Date - Activity Type - Company Status - Company Type - Appointed on - Occupations - Registration Number - Incorporation Date - Last Accounts Date - Next Accounts Date - Records Date - Date of Incorporation - Dissolution Date - Other Names - 'National Country ID ' - Passport Country - Passport Number - National Country ID - Postal Code - TradeMark - Phone - VAT - USA State - Email - ID / Registration Number - Name - Fax Number - Identity Type - Capital - Law - Other Identifers - Total Share Capital - Other Identifiers '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/companies/{caseCommonId}/documents/mandatory': get: summary: Get Mandatory Documents For Company Case description: Gets mandatory documents for company case operationId: 5a4cf0191257bc0f544bda4f parameters: - name: caseCommonId in: path description: '' required: true schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: Returns array mandatory documents categories content: application/json: example: - NEWINC '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/individuals/{caseCommonId}/documents/mandatory': get: summary: Get Mandatory Documents For Individual Case description: Gets mandatory documents for individual case operationId: 5a4cf3c01257bc0f544bda50 parameters: - name: caseCommonId in: path description: '' required: true schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: Returns array mandatory documents categories content: application/json: example: - photoid '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied /companies/import: post: summary: Import Company Case description: Imports company case operationId: 5a5861341257bc0aa819a424 parameters: - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: "Request body should contain company details you want to import, company properties (optional) and company address. See representation example and request body schema. Below provided description of each property:

\r\nentityName - the company name. Optional field;
\r\ncodeiso31662 - country ISO 3166-2 code. Optional field;
\r\ncompanyType - the company type. See possible values in the list below. Optional field;
\r\nproperties - array of the company properties, has same request body structure as described on POST /companies/caseCommonId/properties endpoint. Optional field;
\r\njourneyName - Name of the journey. Optional field;
\r\naddress - the object described company address. Mandatory field
\r\naddress can include the following properties:\r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n\t\r\n \r\n \r\n \r\n \r\n\t\r\n \r\n \r\n \r\n \r\n\t\r\n \r\n \r\n \r\n \r\n\t\r\n \r\n \r\n \r\n \r\n\t\r\n \r\n \r\n \r\n \r\n\t\r\n \r\n \r\n \r\n \r\n\t\r\n \r\n \r\n \r\n \r\n\t\r\n \r\n \r\n \r\n \r\n \r\n
NameDescriptionMandatory
addressLine1Address Line 1No
addressLine2Address Line 2No
postcodeThe postcodeNo
cityThe cityNo
provinceThe state/provinceNo
codeiso31662Address Country ISO 3166-2 codeYes
typeAddress typeNo
rawAddressNot normalized address stringNo
\r\n\r\nIf the rawAddress is provided then it will be normalized, separated and saved by parts. Otherwise, It will try to save address by provided parts.\r\n\r\nPossible company types:\r\n" content: application/json: example: entityName: TEST AIR SERVICES LTD codeiso31662: GB companyType: Private company limited by shares address: codeiso31662: GB rawAddress: '96 96 Pelhurst Road, Ryde, Isle Of Wight, England' properties: - dataType: Company Status data: Active - dataType: Registration Number data: 11111111 journeyName: All responses: '200': description: "Return imported company case details:\r\n\r\ncommon - case common object:\r\n- caseCommonId - newly created company case identifier in Know Your Customer web application;\r\n- caseCustomerId - identifier of the company case for related customer;\r\n- type - case common type code.\r\n- typeString - case common type name. Text representation of the type. Can be \"Company\" or \"Individual\";\r\n- complete - indicates percentage of case automatic verification process completion;\r\n-edit - deprecated field;\r\n- status - current status of the company case, representing the case has been manually \r\nclosed by a user or not. Can be \"Open\" or \"Closed\";\r\n- statusId - representing current state of the case. Available status identifiers see in the table below.\r\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\r\n- isVisible - indicates if the company case is visible in Know Your Customer web \r\n- isAMLCase - indicates should we check on anti money laundering only or not;\r\n- countryRisk - anti money laundering country risk score;\r\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\r\n\r\ncompany - case company object:\r\n- caseCompanyId - company identifier in Know Your Customer web application;\r\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\r\n- type - type of business entity;\r\n- properties - object which can contain different set of data depending from jurisdiction and registry. Will be empty for this operation.\r\n\r\ncaseAddress - case address object:\r\n- caseAddressId - case address identifier in Know Your Customer web application;\r\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\r\n- rawAddress - address received from registry;\r\n- address - normalized address;\r\n\r\nAvailable case common status identifiers:\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n
\r\n

statusId

\r\n
\r\n

Meaning

\r\n
\r\n

Applies to what Cases

\r\n
\r\n

Description

\r\n
\r\n

0

\r\n
\r\n

Initializing

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

\"Initializing Case\" (immediately after case created)

\r\n
\r\n

1

\r\n
\r\n

Data Collection

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

Data Collection is being performed for the case (either manually or automated) the case is considerred on hold until, an automatic or manual intervention gets done

\r\n
\r\n

2

\r\n
\r\n

Data Verification

\r\n
\r\n

\r\n

Companies and Individuals

\r\n

\r\n
\r\n

The Case is being verified for Data accuracy, integrity & quality

\r\n
\r\n

3

\r\n
\r\n

Ready

\r\n
\r\n

Companies and Individuals

\r\n\r\n
\r\n

\"Ready\" (When our automatic processes are finished and all sub-cases are also ready and the user can now work on the case)

\r\n
\r\n

4-49

\r\n
\r\n

Reserved

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

-

\r\n
\r\n

50

\r\n
\r\n

RetrievingBasicData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving basic company data\" (when we get status, registered address etc.)

\r\n
\r\n

51

\r\n
\r\n

IdentifyingControllingEntities

\r\n
\r\n

Companies

\r\n
\r\n

\"Identifying controlling entities\" (when we scan for director information)

\r\n
\r\n

52

\r\n
\r\n

RetrievingExtendedData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving extended company data, if available

\r\n
\r\n

53

\r\n
\r\n

DownloadingCompanyDocuments

\r\n
\r\n

Companies

\r\n
\r\n

\"Downloading company documents\" (while documents are being downloaded and classified)

\r\n
\r\n

54

\r\n
\r\n

IdentifyingBeneficialOwners

\r\n
\r\n

Companies

\r\n
\r\n

Identifying beneficial owners\" (by using OCR, Data Extraction or Machine Learning Techniques)

\r\n
\r\n

55

\r\n
\r\n

PreparingChildren

\r\n
\r\n

Companies

\r\n
\r\n

Preparing sub-case\" (when this case is ready but some parent company shareholder or corporate secretary/director was found and we are waiting for that sub-case to finish)

\r\n
\r\n

56

\r\n
\r\n

CheckingListedEntities

\r\n
\r\n

Companies

\r\n
\r\n

Checking for market listed entities

\r\n
\r\n

57-99

\r\n
\r\n

Reserved

\r\n
\r\n

Companies

\r\n
\r\n\r\n

 

\r\n
\r\n

100

\r\n
\r\n

PerformingAmlChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual AML Checks

\r\n
\r\n

101

\r\n
\r\n

PerformingAddressChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Address Checks in available Jurisdictions

\r\n
\r\n

102

\r\n
\r\n

PerformingCourtChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Courts Data Checks in available Jurisdictions

\r\n
\r\n

103-150

\r\n
\r\n

Reserved

\r\n
\r\n

Individuals

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
" content: application/json: example: details: common: caseCommonId: 10001 caseCustomerId: 889 customerId: 224 customerName: YourCustomer type: 1 typeString: Company scoring: 0 complete: 0 edit: true status: Open statusChangedDatetime: statusChangedBy: statusId: 0 caseDecision: isVisible: true creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorUserName: example@example.com createdDatetime: '2017-10-20T21:30:53.8630000+00:00' updatedBySystem: isAMLCase: false updatedByUser: customerDepartmentId: 1249 customerDepartmentName: Management countryRisk: 4.77 assignedUserId: assignedUserName: link: https://app.knowyourcustomer.com/casecompany/10001/detail company: id: 3777 caseCompanyId: 3777 caseCommonId: 10001 countryCodeISO31662: GB entityName: TEST AIR SERVICES LTD type: description: Case Generated from API2 userId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 createdDatetime: '2017-10-20T21:30:54.0900000+00:00' properties: { } caseAddress: caseAddressId: 9950 caseCommonId: 10001 addressLine1: addressLine2: city: stateProvince: postcode: country: countryCodeISO31662: countryId: rawAddress: address: userId: creatorName: createdDatetime: '2017-10-20T21:30:54.0930000+00:00' '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Internal Error timeStamp: '2017-07-28T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/individuals/{caseCommonId}/documents': get: summary: Individual Documents description: Gets individual documents operationId: 5a7c2edf1257bc18dcd6b71b parameters: - name: caseCommonId in: path description: Case Common identifier required: true schema: type: number - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: Return array of individual documents. content: application/json: example: - caseDocumentId: 227841 category: selfie name: Selfie link: https://kyc.azure-api.net/v2/documents/227841 - caseDocumentId: 227840 category: photoid name: Photo ID link: https://kyc.azure-api.net/v2/documents/227840 - caseDocumentId: 227842 category: poa name: Address link: https://kyc.azure-api.net/v2/documents/227842 '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/companies/{caseCommonId}/link/{childCaseCommonId}': post: summary: Link Case To Company description: Links child case to parent company case operationId: 5a7c75371257bc18dcd6b71c parameters: - name: caseCommonId in: path description: Case Common identifier required: true schema: type: number - name: childCaseCommonId in: path description: Child Case Common identifier required: true schema: type: number - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: "Object describes what type of relation should be created between child case and parent company:\r\n\r\nrelationType - relation type. Possible values described in the table below;\r\n\r\nrelationRole - relation role. In case if relationType is Officer you can provide officer's position. If relationType is Shareholder usually Shareholder string used. If selected any other relationType, relationRole will be ignored;\r\n\r\nshares - In case if relationType is Shareholder you can provide amount of shares.\r\n\r\n\r\nPossible relationType values:\r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n \r\n
Relationship TypeDescription
SpouseSpouse
SpouseEquivalentPartner considered by national law as equivalent to spouse
CohabitantUnmarried partner or cohabitant
ChildChild
StepchildStepchild
DaughterInLawDaughter-in-law
SonInLawSon-in-law
SiblingSibling
StepsiblingStepsibling
HalfSiblingHalf sibling
ParentParent
StepparentStepparent
ParentInLawParent-in-law
GrandParentGrandparent
GrandchildGrandchild
BrotherInLawBrother-in-law
SisterInLawSister-in-law
BusinessAssociateBusiness associate
JointOwnerJoint owner
FellowShareholderOrPartnerFellow shareholder or partner
FinancialAdvisorFinancial Advisor
AttorneyAttorney
LawyerLawyer
AgentAgent
RepresentativeRepresentative
NomineeNominee
PrivatePoliticalAdvisorPrivate political advisor
PayorDirectRelativePayor Direct Relative
PayorOtherPayor Other
ShareholderShareholder
OfficerOfficer
PowerOfAttorneyPower of Attorney
" content: application/json: example: relationType: Shareholder relationRole: Shareholder shares: 50000 responses: '200': description: "Company members structure.\r\n
\r\nAll returned member groups (controllingEntitiesAndIndividuals and shareholdersAndBeneficialOwners) can include cases for individuals and companies.\r\nEach returned member group got title which is represented by controllingEntitiesAndIndividualsTitle and shareholdersAndBeneficialOwnersTitle properties. These properties describe what kind of members the current group contains (\"Controlling Entities and Individuals\", \"Partners and Beneficial Owners\", etc).\r\n
\r\n\r\nEach member result object contains:\r\n- properties - object which can contain different set of data depending from jurisdiction and registry. Each registry provides different set of data.\r\n
Minimum dataset for company member: Company Name, Company Type,\r\n Company Registration Number, Company Status, Creation / Incorporation Date.\r\n
Minimum dataset for individual member: Individual Name, Individual Relation (Director | Secretary | Auditor | etc).\r\n\r\n- isKYCed - indicates if the particular member can be processed and verified;\r\n- memberType - type of the member. Can be \"Company\" or \"Individual\"." content: application/json: example: controllingEntitiesAndIndividualsTitle: Controlling Entities and Individuals controllingEntitiesAndIndividuals: - role: Partner member: firstName: Dan lastName: Linddal Bechmann ANDERSEN caseCommonId: 14150 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 38 C Søndre Alle addressLine2: city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Søndre Alle 38 C , Rønne, 3700 Rønne, Denmark' address: '38 C Søndre Alle, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - role: Partner member: entityName: AKTK ApS caseCommonId: 14151 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 12 Store Torvegade addressLine2: '' city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Store Torvegade 12, 3700 Rønne' address: '12 Store Torvegade, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: Company Type: Private company limited by shares Company Status: Active Creation Date: 27/08/2012 Registration Number: 34692394 Other Names: ALLINGE REVISION ApS; ALLINGE REVISIONSKONTOR ApS; CENTRUM REVISION ApS memberType: Company isKYCed: true - role: Partner member: firstName: Ivan lastName: Søren QVIST caseCommonId: 14152 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 2 A Elses Løkkevej addressLine2: city: Nexø stateProvince: postcode: 3730 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Elses Løkkevej 2 A , Snogebæk, 3730 Nexø, Denmark' address: '2 A Elses Løkkevej, Nexø, 3730, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - role: Partner member: firstName: Ole lastName: BONDERUP caseCommonId: 14153 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 1 Broløkke addressLine2: city: Svaneke stateProvince: postcode: 3740 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Broløkke 1 , Østermarie, 3740 Svaneke, Denmark' address: '1 Broløkke, Svaneke, 3740, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - role: Partner member: firstName: Anders lastName: KOFOED caseCommonId: 14154 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 94 Aaker addressLine2: city: Aakirkeby stateProvince: postcode: 3720 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Søndre Landevej 94 , Aaker, 3720 Aakirkeby, Denmark' address: '94 Aaker, Aakirkeby, 3720, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - role: Partner member: firstName: Tonny lastName: KOFOED caseCommonId: 14155 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 37 Kapelvej addressLine2: city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Kapelvej 37 , Rønne, 3700 Rønne, Denmark' address: '37 Kapelvej, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - role: Director member: firstName: Dan lastName: Linddal Bechmann ANDERSEN caseCommonId: 14150 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 38 C Søndre Alle addressLine2: city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Søndre Alle 38 C , Rønne, 3700 Rønne, Denmark' address: '38 C Søndre Alle, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - role: Director member: entityName: AKTK ApS caseCommonId: 14151 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 12 Store Torvegade addressLine2: '' city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Store Torvegade 12, 3700 Rønne' address: '12 Store Torvegade, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: Company Type: Private company limited by shares Company Status: Active Creation Date: 27/08/2012 Registration Number: 34692394 Other Names: ALLINGE REVISION ApS; ALLINGE REVISIONSKONTOR ApS; CENTRUM REVISION ApS memberType: Company isKYCed: true - role: Director member: firstName: Ivan lastName: Søren QVIST caseCommonId: 14152 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 2 A Elses Løkkevej addressLine2: city: Nexø stateProvince: postcode: 3730 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Elses Løkkevej 2 A , Snogebæk, 3730 Nexø, Denmark' address: '2 A Elses Løkkevej, Nexø, 3730, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: false - role: Director member: firstName: Ole lastName: BONDERUP caseCommonId: 14153 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 1 Broløkke addressLine2: city: Svaneke stateProvince: postcode: 3740 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Broløkke 1 , Østermarie, 3740 Svaneke, Denmark' address: '1 Broløkke, Svaneke, 3740, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: false - role: Director member: firstName: Anders lastName: KOFOED caseCommonId: 14154 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 94 Aaker addressLine2: city: Aakirkeby stateProvince: postcode: 3720 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Søndre Landevej 94 , Aaker, 3720 Aakirkeby, Denmark' address: '94 Aaker, Aakirkeby, 3720, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: false - role: Director member: firstName: Tonny lastName: KOFOED caseCommonId: 14155 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 37 Kapelvej addressLine2: city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Kapelvej 37 , Rønne, 3700 Rønne, Denmark' address: '37 Kapelvej, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: false shareholdersAndBeneficialOwnersTitle: Partners and Beneficial Owners shareholdersAndBeneficialOwners: - shares: 27 member: firstName: Anders lastName: KOFOED caseCommonId: 14154 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 94 Aaker addressLine2: city: Aakirkeby stateProvince: postcode: 3720 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Søndre Landevej 94 , Aaker, 3720 Aakirkeby, Denmark' address: '94 Aaker, Aakirkeby, 3720, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - shares: 27 member: firstName: Tonny lastName: KOFOED caseCommonId: 14155 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 37 Kapelvej addressLine2: city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Kapelvej 37 , Rønne, 3700 Rønne, Denmark' address: '37 Kapelvej, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: true - shares: 0 member: firstName: Dan lastName: Linddal Bechmann ANDERSEN caseCommonId: 14150 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 38 C Søndre Alle addressLine2: city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Søndre Alle 38 C , Rønne, 3700 Rønne, Denmark' address: '38 C Søndre Alle, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: false - shares: 0 member: entityName: AKTK ApS caseCommonId: 14151 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 12 Store Torvegade addressLine2: '' city: Rønne stateProvince: postcode: 3700 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Store Torvegade 12, 3700 Rønne' address: '12 Store Torvegade, Rønne, 3700, Denmark' userId: creatorName: createdDatetime: properties: Company Type: Private company limited by shares Company Status: Active Creation Date: 27/08/2012 Registration Number: 34692394 Other Names: ALLINGE REVISION ApS; ALLINGE REVISIONSKONTOR ApS; CENTRUM REVISION ApS memberType: Company isKYCed: false - shares: 0 member: firstName: Ivan lastName: Søren QVIST caseCommonId: 14152 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 2 A Elses Løkkevej addressLine2: city: Nexø stateProvince: postcode: 3730 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Elses Løkkevej 2 A , Snogebæk, 3730 Nexø, Denmark' address: '2 A Elses Løkkevej, Nexø, 3730, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: false - shares: 0 member: firstName: Ole lastName: BONDERUP caseCommonId: 14153 jurisdictionId: 62 codeISO31662: DK address: caseAddressId: caseCommonId: addressLine1: 1 Broløkke addressLine2: city: Svaneke stateProvince: postcode: 3740 country: Denmark countryCodeISO31662: countryId: 62 rawAddress: 'Broløkke 1 , Østermarie, 3740 Svaneke, Denmark' address: '1 Broløkke, Svaneke, 3740, Denmark' userId: creatorName: createdDatetime: properties: { } memberType: Individual isKYCed: false '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/companies/{caseCommonId}/properties/{dataType}': delete: summary: Remove Company Case Property description: Removes company case property by data type. operationId: 5a4222311257bc0ca8459629 parameters: - name: caseCommonId in: path description: '' required: true schema: type: string - name: dataType in: path description: '' required: true schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: Return all case properties for particular company case. content: application/json: example: - dataType: Activity Type data: Any type - dataType: Other Names data: Test Limited '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid DataType timeStamp: '2017-07-28T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/individuals/{caseCommonId}/properties/{dataType}': delete: summary: Remove Individual Case Property description: Removes individual case property by data type. operationId: 5a422a1a1257bc0ca845962a parameters: - name: caseCommonId in: path description: '' required: true schema: type: string - name: dataType in: path description: '' required: true schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: Return all case properties for particular individual case. content: application/json: example: - dataType: Birth Date data: '2000-01-01T00:00:00.0000000+00:00' '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid DataType timeStamp: '2017-07-28T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/companies/{caseCommonId}/documents/request': post: summary: Request Company Case Documents description: 'Creates request for documents on the given company case, return link to portal to upload requested documents and indicates if sms/email were sent.' operationId: 5a4cf8051257bc0f544bda51 parameters: - name: caseCommonId in: path description: '' required: true schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: "Body should contain array of documents you want to request. Also you can provide optional email and phone number to receive access code to upload requested documents using external portal or mobile application.\r\n- documents - array of documents you want to reqeust. If you are going to request mandatory documenst, you can get categories of these documents for particular case by calling /companies/caseCommonId/documents/mandatory endpoint;\r\n- email - optional email address to receive email with access code and link to upload portal;\r\n- phone - optional phone number to reveive SMS with access code to upload reqeusted documents using mobile application.\r\n- allowEdit - optional paramether that allow edit/add company information." content: application/json: example: documents: - NEWINC - Annual Accounts email: example@example.com phone: '' allowEdit: true responses: '200': description: "Response contains the following data:\r\n- uploadUrl - link to portal to upload requested documents;\r\n- accessCode - access code which should be provided during uploading documents using both upload portal and mobile application;\r\n- emailSent - indicates if email was sent;\r\n- smsSent - indicates if SMS was sent." content: application/json: example: uploadUrl: https://dev.kycl.io/upload/+A00000 accessCode: +A00000 emailSent: true smsSent: false '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-28T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/individuals/{caseCommonId}/documents/request': post: summary: Request Individual Case Documents description: 'Creates request for documents on the given individual case, return link to portal to upload requested documents and indicates if sms/email were sent.' operationId: 5a4d00951257bc0f544bda52 parameters: - name: caseCommonId in: path description: '' required: true schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: "Body should contain array of documents you want to request. Also you can provide optional email and phone number to receive access code to upload requested documents using external portal or mobile application.\r\n- documents - array of documents you want to reqeust. If you are going to upload mandatory document, you can get categories of these documents for particular case by calling /individuals/caseCommonId/documents/mandatory endpoint;\r\n- email - optional email address to receive email with access code and link to upload portal;\r\n- phone - optional phone number to reveive SMS with access code to upload reqeusted documents using mobile application.\r\n- allowEdit - optional paramether that allow to edit/add individual information." content: application/json: example: documents: - photoid email: '' phone: '' allowEdit: true responses: '200': description: "Response contains the following data:\r\n- uploadUrl - link to portal to upload requested documents;\r\n- accessCode - access code which should be provided during uploading documents using both upload portal and mobile application;\r\n- emailSent - indicates if email was sent;\r\n- smsSent - indicates if SMS was sent." content: application/json: example: uploadUrl: https://dev.kycl.io/upload/+A00000 accessCode: +A00000 emailSent: false smsSent: false '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-28T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/companies/{caseCommonId}/documents/upload': post: summary: Upload Document To Company Case description: Uploads the document to company case. operationId: 5a58882f1257bc0aa819a425 parameters: - name: caseCommonId in: path description: '' required: true schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: "Request body includes file you wanted to upload and form-data to describe uploaded document.\r\n\r\nDocument data:
\r\nfileCat - category of the file you want to upload. If you are going to upload mandatory document, you can get categories of the mandatory documents for particular case by calling /companies/caseCommonId/documents/mandatory endpoint;\r\n\r\nname - document name. If you are uploading mandatory document and this document will be found by provided fileCat for particulatr case then the doucument will be saved with standard name defined in the system. Mandatory field;\r\n\r\ncreateNewStep - the flag indicating if new step should be created in the Additional KYC Steps. Please, note, if you create document and category of this document known by the system, then this document will be created in the step defined by system. Otherwise, if current flag is empty or false, then new document will be created in the Other Company Documents step. If flag is true - new step will be created in the Additional KYC Steps section." content: multipart/form-data: { } responses: '200': description: Uploaded document result content: application/json: example: caseCommonId: 16627 caseDocumentId: 93349 category: REPOF name: Register Report <1/12/2018> link: https://kyc.azure-api.net/v2/documents/93349 '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid API Key timeStamp: '2017-07-28T14:15:51.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/individuals/{caseCommonId}/documents/upload': post: summary: Upload Document To Individual Case description: Uploads the document to Individual case. operationId: 5a589e401257bc0aa819a426 parameters: - name: caseCommonId in: path description: '' required: true schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: "Request body includes file you wanted to upload and form-data to describe uploaded document.\r\n\r\nDocument data:
\r\nfileCat - category of the file you want to upload. If you are going to upload mandatory document, you can get categories of the mandatory documents for particular case by calling /individuals/caseCommonId/documents/mandatory endpoint. Default categories are the following: photoid, poa, selfie;\r\n\r\nname - document name. If you are uploading mandatory document and this document will be found by provided fileCat for particulatr case then the doucument will be saved with standard name defined in the system. Mandatory field;\r\n\r\ncreateNewStep - the flag indicating if new step should be created for uploaded document. Please, note, if you create document and category of this document known by the system, then this document will be created in the step defined by system. Otherwise, if current flag is empty or false, then new document will be created in the Proof Of Identity step. If flag is true - new step will be created in the Identity section." content: multipart/form-data: { } responses: '200': description: Uploaded document result content: application/json: example: caseCommonId: 16627 caseDocumentId: 93349 category: photoid name: Photo ID link: https://kyc.azure-api.net/v2/documents/93349 '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid API Key timeStamp: '2017-07-28T14:15:51.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied /individuals/import: post: summary: Import Individual Case description: Import a new individual case operationId: 5af35097049b5e1e7cb9059c parameters: - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: "Individual data.\r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n \r\n
NameDescriptionMandatory
firstNameThe First NameNo
lastNameThe Family NameNo
nationalityCodeiso31662Nationality Country ISO 3166-2 codeNo
birthDateThe Date of Birth (Format: dd/mm/yyyy)No
addressLine1Address Line 1No
addressLine2Address Line 2No
postcodeThe postcodeNo
cityThe cityNo
provinceThe state/provinceNo
countryCodeiso31662Address Country ISO 3166-2 codeNo
propertiesArray of the individual properties, has same request body structure as described at the POST /individuals/caseCommonId/properties endpointNo
journeyNameName of the journeyNo
" content: application/json: example: firstName: John lastName: Doe nationalityCodeiso31662: GB birthDate: '1980-01-01T00:00:00.0000000+00:00' addressLine1: addressLine2: postcode: city: province: countryCodeiso31662: properties: - dataType: BirthDate data: '1990-01-01T00:00:00.0000000+00:00' journeyName: All responses: '200': description: "Return created individual case details:\r\n\r\ncommon - case common object:\r\n- caseCommonId - individual case identifier in Know Your Customer web application;\r\n- caseCustomerId - identifier of the individual case for related customer;\r\n- type - case common type code.\r\n- typeString - case common type name. Text representation of the type;\r\n- complete - indicates percentage of case automatic verification process completion;\r\n- edit - deprecated field;\r\n- status - current status of the individual case, representing the case has been manually \r\nclosed by a user or not. Can be \"Open\" or \"Closed\";\r\n- statusId - representing current state of the case. Available status identifiers see in the table below.\r\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\r\n- isVisible - indicates if the individual case is visible in Know Your Customer web \r\n- isAMLCase - indicates should we check on anti money laundering only or not;\r\n- countryRisk - anti money laundering country risk score;\r\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\r\n\r\nindividual - case individual object:\r\n- caseIndividualId - individual identifier in Know Your Customer web application;\r\n- firstName - individual's first name;\r\n- lastName - individual's last name;\r\n- countryCodeISO31662 - country code of individual case defined in ISO 3166-2 standard;\r\n- nationalityCodeISO31662 - country code of the nationality defined in ISO 3166-2 standard;\r\n- properties - object which can contain different set of data like Date of Birth, Occupdation, etc;\r\n\r\ncaseAddress - case address object:\r\n- caseAddressId - case address identifier in Know Your Customer web application;\r\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\r\n- rawAddress - address received from registry;\r\n- address - normalized address;\r\n\r\nAvailable case common status identifiers:\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n
\r\n

statusId

\r\n
\r\n

Meaning

\r\n
\r\n

Applies to what Cases

\r\n
\r\n

Description

\r\n
\r\n

0

\r\n
\r\n

Initializing

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

\"Initializing Case\" (immediately after case created)

\r\n
\r\n

1

\r\n
\r\n

Data Collection

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

Data Collection is being performed for the case (either manually or automated) the case is considerred on hold until, an automatic or manual intervention gets done

\r\n
\r\n

2

\r\n
\r\n

Data Verification

\r\n
\r\n

\r\n

Companies and Individuals

\r\n

\r\n
\r\n

The Case is being verified for Data accuracy, integrity & quality

\r\n
\r\n

3

\r\n
\r\n

Ready

\r\n
\r\n

Companies and Individuals

\r\n\r\n
\r\n

\"Ready\" (When our automatic processes are finished and all sub-cases are also ready and the user can now work on the case)

\r\n
\r\n

4-49

\r\n
\r\n

Reserved

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

-

\r\n
\r\n

50

\r\n
\r\n

RetrievingBasicData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving basic company data\" (when we get status, registered address etc.)

\r\n
\r\n

51

\r\n
\r\n

IdentifyingControllingEntities

\r\n
\r\n

Companies

\r\n
\r\n

\"Identifying controlling entities\" (when we scan for director information)

\r\n
\r\n

52

\r\n
\r\n

RetrievingExtendedData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving extended company data, if available

\r\n
\r\n

53

\r\n
\r\n

DownloadingCompanyDocuments

\r\n
\r\n

Companies

\r\n
\r\n

\"Downloading company documents\" (while documents are being downloaded and classified)

\r\n
\r\n

54

\r\n
\r\n

IdentifyingBeneficialOwners

\r\n
\r\n

Companies

\r\n
\r\n

Identifying beneficial owners\" (by using OCR, Data Extraction or Machine Learning Techniques)

\r\n
\r\n

55

\r\n
\r\n

PreparingChildren

\r\n
\r\n

Companies

\r\n
\r\n

Preparing sub-case\" (when this case is ready but some parent company shareholder or corporate secretary/director was found and we are waiting for that sub-case to finish)

\r\n
\r\n

56

\r\n
\r\n

CheckingListedEntities

\r\n
\r\n

Companies

\r\n
\r\n

Checking for market listed entities

\r\n
\r\n

57-99

\r\n
\r\n

Reserved

\r\n
\r\n

Companies

\r\n
\r\n\r\n

 

\r\n
\r\n

100

\r\n
\r\n

PerformingAmlChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual AML Checks

\r\n
\r\n

101

\r\n
\r\n

PerformingAddressChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Address Checks in available Jurisdictions

\r\n
\r\n

102

\r\n
\r\n

PerformingCourtChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Courts Data Checks in available Jurisdictions

\r\n
\r\n

103-150

\r\n
\r\n

Reserved

\r\n
\r\n

Individuals

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
" content: application/json: example: caseDetail: details: individual: caseIndividualId: 8905 firstName: John lastName: Doe countryCodeISO31662: PT country: Portugal email: phone: nationalityCountryCodeISO31662: GB nationalityCountry: United kingdom caseCommonId: 14050 creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 properties: Birth Date: '1990-01-01T00:00:00.0000000+00:00' createdDatetime: '2017-11-24T11:44:17.2200000+00:00' common: caseCommonId: 14069 caseCustomerId: 1165 customerId: 224 customerName: AndreiCo type: 2 typeString: Individual scoring: 0 complete: 0 edit: true status: Open statusChangedDatetime: statusChangedBy: statusId: caseDecision: isVisible: true creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorUserName: avgybarev@gmail.com createdDatetime: '2017-11-24T13:41:58.0300000+00:00' updatedBySystem: isAMLCase: updatedByUser: customerDepartmentId: 1249 customerDepartmentName: Management countryRisk: 4.77 assignedUserId: assignedUserName: link: https://dev.knowyourcustomer.com/caseindividual/14069/detail caseAddress: caseAddressId: 7792 caseCommonId: 7839 addressLine1: 40-44 Wyndham Place Wyndham Street Central addressLine2: '' city: Hong Kong stateProvince: postcode: country: Hong kong countryCodeISO31662: HK countryId: 3 rawAddress: '6/F., WYNDHAM PLACE,40-44 WYNDHAM STREET, CENTRAL, HONG KONG, HONG KONG' address: '40-44 Wyndham Place Wyndham Street Central, Hong Kong, Hong kong' userId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorName: example@example.com createdDatetime: '2017-09-26T05:22:52.8930000+00:00' '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Internal Error timeStamp: '2017-07-28T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/individuals/{caseCommonId}/link/{childCaseCommonId}': post: summary: Link Individual Case To Individual description: Links individual child case to parent individual case. operationId: 5abde14d049b5e19fce1a103 parameters: - name: caseCommonId in: path description: Case Common identifier required: true schema: type: number - name: childCaseCommonId in: path description: Child Case Common identifier required: true schema: type: number - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: "Object describes what type of relation should be created between child case and parent individual:\r\n\r\nrelationType - relation type. Possible values described in the table below.\r\n\r\nPossible relationType values:\r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n \r\n
Relationship TypeDescription
SpouseSpouse
SpouseEquivalentPartner considered by national law as equivalent to spouse
CohabitantUnmarried partner or cohabitant
ChildChild
StepchildStepchild
DaughterInLawDaughter-in-law
SonInLawSon-in-law
SiblingSibling
StepsiblingStepsibling
HalfSiblingHalf sibling
ParentParent
StepparentStepparent
ParentInLawParent-in-law
GrandParentGrandparent
GrandchildGrandchild
BrotherInLawBrother-in-law
SisterInLawSister-in-law
BusinessAssociateBusiness associate
JointOwnerJoint owner
FellowShareholderOrPartnerFellow shareholder or partner
FinancialAdvisorFinancial Advisor
AttorneyAttorney
LawyerLawyer
AgentAgent
RepresentativeRepresentative
NomineeNominee
PrivatePoliticalAdvisorPrivate political advisor
PayorDirectRelativePayor Direct Relative
PayorOtherPayor Other
PowerOfAttorneyPower of Attorney
" content: application/json: example: relationType: Agent responses: '200': description: Return new created relationship description. content: application/json: example: success: true relationshipDescriptions: - Sibling '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/companies/{caseCommonId}/identity': put: summary: Update Company description: Update existing company identity information. operationId: 5af2ed13049b5e10c0c830b8 parameters: - name: caseCommonId in: path description: '' required: true schema: type: number - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: "Company data.\r\n\r\n \r\n\t\t\r\n\t\t\t\r\n \r\n \r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\t\r\n\t\t\r\n\t\r\n
NameDescriptionMandatory
codeiso31662Country ISO 3166-2 codeNo
entityNameCompany NameNo
externalCodeCompany registration numberNo
addressLine1Address Line 1No
addressLine2Address Line 2No
postcodePostcodeNo
cityCityNo
provinceProvinceNo
countryCodeiso31662Address Country ISO 3166-2 codeNo
" content: application/json: example: codeiso31662: GB entityName: UNITED ACCESS SERVICES LIMITED entityType: Company companyType: Private company limited by shares addressLine1: Green st. addressLine2: 10 postcode: 385493 city: Garlem countryCodeiso31662: IE responses: '200': description: "Return created company case details:\r\n\r\ncommon - case common object:\r\n- caseCommonId - newly created company case identifier in Know Your Customer web application;\r\n- caseCustomerId - identifier of the company case for related customer;\r\n- type - case common type code.\r\n- typeString - case common type name. Text representation of the type. Can be \"Company\" or \"Individual\";\r\n- complete - indicates percentage of case automatic verification process completion;\r\n-edit - deprecated field;\r\n- status - current status of the company case, representing the case has been manually \r\nclosed by a user or not. Can be \"Open\" or \"Closed\";\r\n- statusId - represents current state of the case. Available status identifiers see in the table below.\r\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\r\n- isVisible - indicates if the company case is visible in Know Your Customer web \r\n- isAMLCase - indicates should we check on anti money laundering only or not;\r\n- countryRisk - anti money laundering country risk score;\r\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\r\n\r\ncompany - case company object:\r\n- caseCompanyId - company identifier in Know Your Customer web application;\r\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\r\n- type - type of business entity;\r\n- properties - object which can contain different set of data depending from jurisdiction and registry. Will be empty for this operation.\r\n\r\ncaseAddress - case address object:\r\n- caseAddressId - case address identifier in Know Your Customer web application;\r\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\r\n- rawAddress - address received from registry;\r\n- address - normalized address;\r\n\r\nAvailable case common status identifiers:\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n
\r\n

statusId

\r\n
\r\n

Meaning

\r\n
\r\n

Applies to what Cases

\r\n
\r\n

Description

\r\n
\r\n

0

\r\n
\r\n

Initializing

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

\"Initializing Case\" (immediately after case created)

\r\n
\r\n

1

\r\n
\r\n

Data Collection

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

Data Collection is being performed for the case (either manually or automated) the case is considerred on hold until, an automatic or manual intervention gets done

\r\n
\r\n

2

\r\n
\r\n

Data Verification

\r\n
\r\n

\r\n

Companies and Individuals

\r\n

\r\n
\r\n

The Case is being verified for Data accuracy, integrity & quality

\r\n
\r\n

3

\r\n
\r\n

Ready

\r\n
\r\n

Companies and Individuals

\r\n\r\n
\r\n

\"Ready\" (When our automatic processes are finished and all sub-cases are also ready and the user can now work on the case)

\r\n
\r\n

4-49

\r\n
\r\n

Reserved

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

-

\r\n
\r\n

50

\r\n
\r\n

RetrievingBasicData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving basic company data\" (when we get status, registered address etc.)

\r\n
\r\n

51

\r\n
\r\n

IdentifyingControllingEntities

\r\n
\r\n

Companies

\r\n
\r\n

\"Identifying controlling entities\" (when we scan for director information)

\r\n
\r\n

52

\r\n
\r\n

RetrievingExtendedData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving extended company data, if available

\r\n
\r\n

53

\r\n
\r\n

DownloadingCompanyDocuments

\r\n
\r\n

Companies

\r\n
\r\n

\"Downloading company documents\" (while documents are being downloaded and classified)

\r\n
\r\n

54

\r\n
\r\n

IdentifyingBeneficialOwners

\r\n
\r\n

Companies

\r\n
\r\n

Identifying beneficial owners\" (by using OCR, Data Extraction or Machine Learning Techniques)

\r\n
\r\n

55

\r\n
\r\n

PreparingChildren

\r\n
\r\n

Companies

\r\n
\r\n

Preparing sub-case\" (when this case is ready but some parent company shareholder or corporate secretary/director was found and we are waiting for that sub-case to finish)

\r\n
\r\n

56

\r\n
\r\n

CheckingListedEntities

\r\n
\r\n

Companies

\r\n
\r\n

Checking for market listed entities

\r\n
\r\n

57-99

\r\n
\r\n

Reserved

\r\n
\r\n

Companies

\r\n
\r\n\r\n

 

\r\n
\r\n

100

\r\n
\r\n

PerformingAmlChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual AML Checks

\r\n
\r\n

101

\r\n
\r\n

PerformingAddressChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Address Checks in available Jurisdictions

\r\n
\r\n

102

\r\n
\r\n

PerformingCourtChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Courts Data Checks in available Jurisdictions

\r\n
\r\n

103-150

\r\n
\r\n

Reserved

\r\n
\r\n

Individuals

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
" content: application/json: example: caseDetail: details: common: caseCommonId: 10001 caseCustomerId: 889 customerId: 224 customerName: YourCustomer type: 1 typeString: Company scoring: 0 complete: 0 edit: true status: Open statusChangedDatetime: statusChangedBy: statusId: 0 caseDecision: isVisible: true creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorUserName: example@example.com createdDatetime: '2017-10-20T21:30:53.8630000+00:00' updatedBySystem: isAMLCase: false updatedByUser: customerDepartmentId: 1249 customerDepartmentName: Management countryRisk: 4.77 assignedUserId: assignedUserName: link: https://app.knowyourcustomer.com/casecompany/10001/detail company: id: 3777 caseCompanyId: 3777 caseCommonId: 10001 countryCodeISO31662: GB entityName: TEST AIR SERVICES LTD type: description: Case Generated from API2 userId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 createdDatetime: '2017-10-20T21:30:54.0900000+00:00' properties: { } caseAddress: caseAddressId: 9950 caseCommonId: 10001 addressLine1: addressLine2: city: stateProvince: postcode: country: countryCodeISO31662: countryId: rawAddress: address: userId: creatorName: createdDatetime: '2017-10-20T21:30:54.0930000+00:00' '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Internal Error timeStamp: '2017-07-28T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/individuals/{caseCommonId}/identity': put: summary: Update Individual Case description: Update an existing individual case operationId: 5af2efbb049b5e10c0c830b9 parameters: - name: caseCommonId in: path required: true schema: type: number - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: "Individual data.\r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n\t\t\r\n \r\n \r\n \r\n \r\n \r\n
NameDescriptionMandatory
firstNameThe First NameNo
lastNameThe Family NameNo
nationalityCodeiso31662Nationality Country ISO 3166-2 codeNo
birthDateThe Date of Birth (Format: dd/mm/yyyy)No
addressLine1Address Line 1No
addressLine2Address Line 2No
postcodeThe postcodeNo
cityThe cityNo
provinceThe state/provinceNo
countryCodeiso31662Address Country ISO 3166-2 codeNo
" content: application/json: example: firstName: John lastName: Doe nationalityCodeiso31662: GB birthDate: '1980-01-01T00:00:00.0000000+00:00' addressLine1: addressLine2: postcode: city: province: countryCodeiso31662: properties: - dataType: BirthDate data: '1990-01-01T00:00:00.0000000+00:00' journeyName: All responses: '200': description: "Return created individual case details:\r\n\r\ncommon - case common object:\r\n- caseCommonId - individual case identifier in Know Your Customer web application;\r\n- caseCustomerId - identifier of the individual case for related customer;\r\n- type - case common type code.\r\n- typeString - case common type name. Text representation of the type;\r\n- complete - indicates percentage of case automatic verification process completion;\r\n- edit - deprecated field;\r\n- status - current status of the individual case, representing the case has been manually \r\nclosed by a user or not. Can be \"Open\" or \"Closed\";\r\n- statusId - representing current state of the case. Available status identifiers see in the table below.\r\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\r\n- isVisible - indicates if the individual case is visible in Know Your Customer web \r\n- isAMLCase - indicates should we check on anti money laundering only or not;\r\n- countryRisk - anti money laundering country risk score;\r\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\r\n\r\nindividual - case individual object:\r\n- caseIndividualId - individual identifier in Know Your Customer web application;\r\n- firstName - individual's first name;\r\n- lastName - individual's last name;\r\n- countryCodeISO31662 - country code of individual case defined in ISO 3166-2 standard;\r\n- nationalityCodeISO31662 - country code of the nationality defined in ISO 3166-2 standard;\r\n- properties - object which can contain different set of data like Date of Birth, Occupdation, etc;\r\n\r\ncaseAddress - case address object:\r\n- caseAddressId - case address identifier in Know Your Customer web application;\r\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\r\n- rawAddress - address received from registry;\r\n- address - normalized address;\r\n\r\nAvailable case common status identifiers:\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n
\r\n

statusId

\r\n
\r\n

Meaning

\r\n
\r\n

Applies to what Cases

\r\n
\r\n

Description

\r\n
\r\n

0

\r\n
\r\n

Initializing

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

\"Initializing Case\" (immediately after case created)

\r\n
\r\n

1

\r\n
\r\n

Data Collection

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

Data Collection is being performed for the case (either manually or automated) the case is considerred on hold until, an automatic or manual intervention gets done

\r\n
\r\n

2

\r\n
\r\n

Data Verification

\r\n
\r\n

\r\n

Companies and Individuals

\r\n

\r\n
\r\n

The Case is being verified for Data accuracy, integrity & quality

\r\n
\r\n

3

\r\n
\r\n

Ready

\r\n
\r\n

Companies and Individuals

\r\n\r\n
\r\n

\"Ready\" (When our automatic processes are finished and all sub-cases are also ready and the user can now work on the case)

\r\n
\r\n

4-49

\r\n
\r\n

Reserved

\r\n
\r\n

Companies and Individuals

\r\n
\r\n

-

\r\n
\r\n

50

\r\n
\r\n

RetrievingBasicData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving basic company data\" (when we get status, registered address etc.)

\r\n
\r\n

51

\r\n
\r\n

IdentifyingControllingEntities

\r\n
\r\n

Companies

\r\n
\r\n

\"Identifying controlling entities\" (when we scan for director information)

\r\n
\r\n

52

\r\n
\r\n

RetrievingExtendedData

\r\n
\r\n

Companies

\r\n
\r\n

Retrieving extended company data, if available

\r\n
\r\n

53

\r\n
\r\n

DownloadingCompanyDocuments

\r\n
\r\n

Companies

\r\n
\r\n

\"Downloading company documents\" (while documents are being downloaded and classified)

\r\n
\r\n

54

\r\n
\r\n

IdentifyingBeneficialOwners

\r\n
\r\n

Companies

\r\n
\r\n

Identifying beneficial owners\" (by using OCR, Data Extraction or Machine Learning Techniques)

\r\n
\r\n

55

\r\n
\r\n

PreparingChildren

\r\n
\r\n

Companies

\r\n
\r\n

Preparing sub-case\" (when this case is ready but some parent company shareholder or corporate secretary/director was found and we are waiting for that sub-case to finish)

\r\n
\r\n

56

\r\n
\r\n

CheckingListedEntities

\r\n
\r\n

Companies

\r\n
\r\n

Checking for market listed entities

\r\n
\r\n

57-99

\r\n
\r\n

Reserved

\r\n
\r\n

Companies

\r\n
\r\n\r\n

 

\r\n
\r\n

100

\r\n
\r\n

PerformingAmlChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual AML Checks

\r\n
\r\n

101

\r\n
\r\n

PerformingAddressChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Address Checks in available Jurisdictions

\r\n
\r\n

102

\r\n
\r\n

PerformingCourtChecks

\r\n
\r\n

Individuals

\r\n
\r\n

Performing Individual Courts Data Checks in available Jurisdictions

\r\n
\r\n

103-150

\r\n
\r\n

Reserved

\r\n
\r\n

Individuals

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
\r\n\r\n

 

\r\n
" content: application/json: example: caseDetail: details: individual: caseIndividualId: 8905 firstName: John lastName: Doe countryCodeISO31662: PT country: Portugal email: phone: nationalityCountryCodeISO31662: GB nationalityCountry: United kingdom caseCommonId: 14050 creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 properties: Birth Date: '1990-01-01T00:00:00.0000000+00:00' createdDatetime: '2017-11-24T11:44:17.2200000+00:00' common: caseCommonId: 14069 caseCustomerId: 1165 customerId: 224 customerName: AndreiCo type: 2 typeString: Individual scoring: 0 complete: 0 edit: true status: Open statusChangedDatetime: statusChangedBy: statusId: caseDecision: isVisible: true creatorId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorUserName: avgybarev@gmail.com createdDatetime: '2017-11-24T13:41:58.0300000+00:00' updatedBySystem: isAMLCase: updatedByUser: customerDepartmentId: 1249 customerDepartmentName: Management countryRisk: 4.77 assignedUserId: assignedUserName: link: https://dev.knowyourcustomer.com/caseindividual/14069/detail caseAddress: caseAddressId: 7792 caseCommonId: 7839 addressLine1: 40-44 Wyndham Place Wyndham Street Central addressLine2: '' city: Hong Kong stateProvince: postcode: country: Hong kong countryCodeISO31662: HK countryId: 3 rawAddress: '6/F., WYNDHAM PLACE,40-44 WYNDHAM STREET, CENTRAL, HONG KONG, HONG KONG' address: '40-44 Wyndham Place Wyndham Street Central, Hong Kong, Hong kong' userId: db557fed-99b5-4c8a-b3c9-5d2d42d2bc13 creatorName: example@example.com createdDatetime: '2017-09-26T05:22:52.8930000+00:00' '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Internal Error timeStamp: '2017-07-28T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied /companytypes: get: summary: Company Types description: Get available jurisdictions operationId: 5b84e90ff664c597254ec0cd parameters: - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: Returns list of the available jurisdictions content: application/json: example: - Branch - Company limited by guarantee - Consortium - Cooperative - Corporation - External company - Foreign branch - Foreign Companie - Foreign subsidiary company - Foundation - General partnership - Government owned with variable capital and variable shareholders - Incorporated - Investment company - Limited Liability Company - Limited liability cooperative - Limited liability foundation - Limited Liability Limited Partnership - Limited Liability Partnerships - Limited Partnership - Limited partnership - ILP - Limited partnership - LLP - Limited partnership - LP - Madras - Management Corporation - Mosque - National Association - National Trust and Savings Association - News Bureau - Other/Non-corporate - Other/Partnership - Private company - Private company limited by guarantee without share capital - Private company limited by shares - Private foundation - Professional Limited Liability Company - Property management company - Public Accounting Firm - Public company - Public Company Limited by Guarantee - Public company limited by shares - Register of Commerce and Companies - Sole proprietorship - State-owned enterprise - Trade Union - Trust - Undetermined - Unlimited company '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid API Key timeStamp: '2017-07-28T14:15:51.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/companies/{caseCommonId}/amlchecks': get: summary: Company AML Checks description: Gets the AML Check results for the selected company operationId: 5bed8b6c24ff61cef6216e33 parameters: - name: caseCommonId in: path description: Case Common identifier required: true schema: type: number - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: "Returns all AML Check entries found in the case and not excluded\r\n\r\ncompany - case common details:\r\n- caseCommonId - company case identifier in Know Your Customer web application;\r\n- lastName - the name of the company;\r\n\r\nworldChecks - all AML entries found in WorldCheck. Each entity has the following properties:\r\n- category - the type of company (e.g. CORPORATE, BANK, etc.);\r\n- firstName - always empty;\r\n- lastName - the name of the company found in Worldcheck;\r\n- dateOfBirth - always empty;\r\n- placeOfBirth - always empty;\r\n- citizenship - country in which the company operates;\r\n- aliases - other possible names for the company;\r\n- entered - date in which the entry was added in WorldCheck;\r\n- externalMediaFound - links to additional information about the entry;\r\n- furtherInformation - additional information about the entry;\r\n- locations - additional details about the location in which the entry was added;\r\n\r\nlexisNexisChecks - all AML entries found in LexisNexis. Each entity has the following properties:\r\n- category - the type of AML entry (e.g. PEP, ADVERSEMEDIA, etc.);\r\n- firstName - always empty;\r\n- lastName - the name of the company found in Worldcheck;\r\n- dateOfBirth - always empty;\r\n- placeOfBirth - always empty;\r\n- occupation - always empty;\r\n- entered - date in which the entry was added in WorldCheck;\r\n- associations - additional information about the entry;\r\n" content: application/json: example: company: caseCommonId: 100921 lastName: TESTING COMPANY worldChecks: - category: CORPORATE firstName: '' lastName: TESTING COMPANY dateOfBirth: '' placeOfBirth: '' citizenship: INDONESIA aliases: ALIAS COMPANY entered: '2002-02-08T00:00:00.0000000+00:00' externalMediaFound: https://en.wikipedia.org/wiki/Lorem_ipsum https://en.wikipedia.org/wiki/Lorem_ipsum furtherInformation: '[BIOGRAPHY] Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc sapien quam, tempor nec ipsum a. (PEP) (1966- ). [IDENTIFICATION] To be determined. [REPORTS] To be determined.' locations: '~ Lake Providence, Louisiana ~ USA' lexisNexisChecks: - category: PEP firstName: '' lastName: TESTING COMPANY dateOfBirth: placeOfBirth: occupation: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc sapien quam, tempor nec ipsum a.' entered: '2016-08-04T00:00:00.0000000+00:00' associations: 'Wife (PEP:Govt Branch Member): Testing, Name, 1328143,Relative (PEP:Govt Branch Member): Name, Test Other, 124531' '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied '/individuals/{caseCommonId}/amlchecks': get: summary: Individual AML Checks description: Gets AML Check results for the selected case operationId: 5bed8a736951ef71f349d631 parameters: - name: caseCommonId in: path description: Case Common identifier required: true schema: type: number - name: ApiKey in: header description: '' required: true schema: type: string responses: '200': description: "Returns all AML Check entries found in the case and not excluded\r\n\r\nindividual - case common details:\r\n- caseCommonId - company case identifier in Know Your Customer web application;\r\n- lastName - the last name of the person;\r\n- firstName - the first name of the person;\r\n\r\nworldChecks - all AML entries found in WorldCheck. Each entity has the following properties:\r\n- category - the type of AML entry (e.g. INDIVIDUAL, TERRORISM, LEGAL, etc.);\r\n- firstName - the first name of the person;\r\n- lastName - the last name of the person;\r\n- dateOfBirth - the date in which person was born;\r\n- placeOfBirth - the location in which person was born;\r\n- citizenship - the citizenship of hte person;\r\n- aliases - other names found for the person;\r\n- entered - date in which the entry was added in WorldCheck;\r\n- externalMediaFound - links to additional information about the entry;\r\n- furtherInformation - additional information about the entry;\r\n- locations - additional details about the location in which the entry was added;\r\n\r\nlexisNexisChecks - all AML entries found in LexisNexis. Each entity has the following properties:\r\n- category - the type of AML entry (e.g. INDIVIDUAL, TERRORISM, LEGAL, etc.);\r\n- firstName the first name of the person;\r\n- lastName - the last name of the person;\r\n- dateOfBirth - the date in which person was born;\r\n- placeOfBirth - the location in which person was born;\r\n- occupation - the occupation of the person;\r\n- entered - date in which the entry was added in WorldCheck;\r\n- associations - additional information about the entry;\r\n" content: application/json: example: individual: caseCommonId: 14456 lastName: Testing firstName: Individual worldChecks: - category: LEGAL firstName: Testing I lastName: Indivdual dateOfBirth: '' placeOfBirth: '' citizenship: USA aliases: '' entered: '2010-08-24T00:00:00.0000000+00:00' externalMediaFound: https://en.wikipedia.org/wiki/Lorem_ipsum https://en.wikipedia.org/wiki/Lorem_ipsum furtherInformation: '[BIOGRAPHY] Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc sapien quam, tempor nec ipsum a. (reported 2009). [IDENTIFICATION] To be determined. [REPORTS] To be determined.' locations: '~ Lake Providence, Louisiana ~ USA' lexisNexisChecks: [ ] '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied components: securitySchemes: apiKeyHeader: type: apiKey name: Ocp-Apim-Subscription-Key in: header apiKeyQuery: type: apiKey name: subscription-key in: query security: - apiKeyHeader: [ ] - apiKeyQuery: [ ] x-ms-export-notes: - 'The exported API contains schemas that aren''t of content type ''application/vnd.oai.openapi.components+json'', and are hence not exported as OpenAPI components.' x-ms-paths: '/verification/identity?caseCommonId={caseCommonId}': post: summary: Verify Individual Identity description: "Verifies uploaded passport document of the specified individual and performs First Name / Last Name / Birth Date comparison. (Result is not saved in the case)\r\n\r\nFinal verification result can be accessed from success or triggeredRule property. Properties are described in the response schema." operationId: 597b372afe9cef0db4739714 parameters: - name: caseCommonId in: query description: '' required: true schema: type: string - name: ApiKey in: header description: '' required: true schema: type: string requestBody: description: Passport image. The request to verify passport should contain header Content-Type with multipart/form-data value. content: multipart/form-data: { } responses: '200': description: Verification result content: application/json: example: comparisonReport: firstNameConfirmation: value: Kevin Richard recognizedValue: KEVIN RICHARD status: Confirmed lastNameConfirmation: value: Halligen recognizedValue: HALLIGEN status: Confirmed birthDateConfirmation: badDateValueReason: value: '2017-10-08T00:00:00.0000000+00:00' recognizedValue: '1961-07-14T00:00:00.0000000+00:00' status: Deviates success: false message: triggeredRule: scenario: '#4' result: Fail message: DataElementsMistmach sensitivity: Low decision: Deviates properties: failUpload: false imageQuality: percentage: 71 value: High forgeryTests: - group: Data Integrity type: Check Sum - Date of Birth result: Authenticated - group: Data Integrity type: Check Sum - Date of Expiry result: Authenticated - group: Data Integrity type: Check Sum - Document Number result: Authenticated - group: Data Integrity type: Check Sum - General result: Authenticated - group: Data Integrity type: Check Sum - Optional Data result: Authenticated - group: Data Integrity type: Data Comparison - Date of Birth result: NotRelevant - group: Data Integrity type: Data Comparison - Expiry Date result: NotRelevant - group: Data Integrity type: Data Comparison - Last Name result: Unconclusive - group: Data Integrity type: Validation - MRZ Date of Birth result: Authenticated - group: Data Integrity type: Validation - MRZ Date of Expiry result: Authenticated - group: Digital type: Photo Replacement result: Authenticated - group: Digital type: Text Replacement result: NotRelevant - group: Structure type: Complete MRZ result: Authenticated - group: Structure type: MRZ Fonts - Alphabetic result: NotRelevant - group: Structure type: MRZ Fonts - Digits result: Authenticated identityReport: firstName: KEVIN RICHARD lastName: HALLIGEN birthDate: '1961-07-14T00:00:00.0000000+00:00' sourceDocument: Passport birthPlace: expiryDate: '2012-02-13T00:00:00.0000000+00:00' documentNumber: S196082 address: '400': description: Invalid request parameters content: application/json: example: statusCode: 400 message: Api Error apiErrors: - description: Invalid CaseCommonId timeStamp: '2017-07-25T12:26:21.0000000+00:00' '401': description: Missing subscription key content: application/json: example: statusCode: 401 message: Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. '403': description: Access denied content: application/json: example: statusCode: 403 message: Access denied