{ "swagger": "2.0", "info": { "title": "KYC API v2", "version": "1.0" }, "host": "api-demo.knowyourcustomer.com", "basePath": "/v2", "schemes": [ "https" ], "securityDefinitions": { "apiKeyHeader": { "type": "apiKey", "name": "Ocp-Apim-Subscription-Key", "in": "header" }, "apiKeyQuery": { "type": "apiKey", "name": "subscription-key", "in": "query" } }, "security": [ { "apiKeyHeader": [] }, { "apiKeyQuery": [] } ], "paths": { "/companies/{caseCommonId}": { "get": { "description": "Gets company case details", "operationId": "597b372afe9cef0db473970c", "summary": "Company Details", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns company case details\n\ncommon - case common object:\n- caseCommonId - company case identifier in Know Your Customer web application;\n- caseCustomerId - identifier of the company case for related customer;\n- type - case common type code.\n- typeString - case common type name. Text representation of the type;\n- complete - indicates percentage of case automatic verification process completion;\n- edit - deprecated field;\n- status - current status of the company case, representing the case has been manually closed by a user or not. Can be \"Open\" or \"Closed\";\n- statusId - represents current state of the case. Available status identifiers see in the table below.\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\n- isVisible - indicates if the company case is visible in Know Your Customer web\n- isAMLCase - indicates should we check on anti money laundering only or not;\n- countryRisk - anti money laundering country risk score;\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\n- caseProcessingType - case processing type, \"\" for regular case processing, \"Lite\" for KYC Lite cases\n- isComplexStructure - True if the maximum tree path is bigger than configured \"Case Drilldown\";\n- caseDrillDownLevel - The maximum tree path is bigger than configured of the current case;\n\nisCaseAMLPositive - True if the case contains at least one AML check not excluded. False otherwise\n\ncompany - case company object:\n- caseCompanyId - company identifier in Know Your Customer web application;\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\n- type - type of business entity;\n- properties - object which can contain different set of data depending from jurisdiction and registry. Each registry provides different set of data.\n\ncaseAddress - case address object:\n- caseAddressId - case address identifier in Know Your Customer web application;\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\n- rawAddress - address received from registry;\n- address - normalized address;\n\nAvailable case common status identifiers:\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

statusId

\n
\n

Meaning

\n
\n

Applies to what Cases

\n
\n

Description

\n
\n

0

\n
\n

Initializing

\n
\n

Companies and Individuals

\n
\n

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

\n
\n

1

\n
\n

Data Collection

\n
\n

Companies and Individuals

\n
\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

\n
\n

2

\n
\n

Data Verification

\n
\n

\n

Companies and Individuals

\n

\n
\n

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

\n
\n

3

\n
\n

Ready

\n
\n

Companies and Individuals

\n\n
\n

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

\n
\n

4-49

\n
\n

Reserved

\n
\n

Companies and Individuals

\n
\n

-

\n
\n

50

\n
\n

RetrievingBasicData

\n
\n

Companies

\n
\n

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

\n
\n

51

\n
\n

IdentifyingControllingEntities

\n
\n

Companies

\n
\n

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

\n
\n

52

\n
\n

RetrievingExtendedData

\n
\n

Companies

\n
\n

Retrieving extended company data, if available

\n
\n

53

\n
\n

DownloadingCompanyDocuments

\n
\n

Companies

\n
\n

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

\n
\n

54

\n
\n

IdentifyingBeneficialOwners

\n
\n

Companies

\n
\n

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

\n
\n

55

\n
\n

PreparingChildren

\n
\n

Companies

\n
\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)

\n
\n

56

\n
\n

CheckingListedEntities

\n
\n

Companies

\n
\n

Checking for market listed entities

\n
\n

57-99

\n
\n

Reserved

\n
\n

Companies

\n
\n\n

 

\n
\n

100

\n
\n

PerformingAmlChecks

\n
\n

Individuals

\n
\n

Performing Individual AML Checks

\n
\n

101

\n
\n

PerformingAddressChecks

\n
\n

Individuals

\n
\n

Performing Individual Address Checks in available Jurisdictions

\n
\n

102

\n
\n

PerformingCourtChecks

\n
\n

Individuals

\n
\n

Performing Individual Courts Data Checks in available Jurisdictions

\n
\n

103-150

\n
\n

Reserved

\n
\n

Individuals

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n", "schema": { "$ref": "#/definitions/CaseDetailResult" }, "examples": { "application/json": { "caseDetail": { "details": { "common": { "caseCommonId": 7839, "caseCustomerId": 677, "customerId": 224, "customerName": "YourCustomer", "type": 1, "typeString": "Company", "scoring": 0, "complete": 55, "edit": true, "status": "Open", "statusChangedDatetime": null, "statusChangedBy": null, "statusId": 3, "caseDecision": "Accepted", "isVisible": true, "creatorId": "db557fed-99b5-4c8a-b3c9-5d2d42d2bc13", "creatorUserName": "example@example.com", "createdDatetime": "2017-09-26T05:22:52.847", "updatedBySystem": "2017-09-26T05:26:11.41", "isAMLCase": false, "updatedByUser": null, "customerDepartmentId": 1249, "customerDepartmentName": "Management", "countryRisk": 5.51, "assignedUserId": null, "assignedUserName": null, "link": "https://app.knowyourcustomer.com/casecompany/7839/detail", "caseProcessingType": "", "isComplexStructure": true, "caseDrillDownLevel": 2 }, "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.893", "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": null, "postcode": null, "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.893" } } } } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] }, "delete": { "description": "Removes company case ", "operationId": "5cdbabdb1a521c56f5a81585", "summary": "Remove Company Case", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case common identifier", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Success message", "schema": { "$ref": "#/definitions/" }, "examples": { "application/json": { "message": "Case deleted successfully" } } }, "400": { "description": "Invalid request parameters / Access denied", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid request: Delete case: access denied.", "timeStamp": "5/15/2019 7:35:39 AM" } ] } } } }, "produces": [ "application/json" ] } }, "/companies/{caseCommonId}/documents": { "get": { "description": "Gets company documents", "operationId": "597b372afe9cef0db4739710", "summary": "Company Documents", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns case documents structure.\ndocuments - object which contains grouped documents for requested case and sub-cases (child cases).\nEach sub-case can contain own documents object which includes documents related to this one sub-case. Sub-cases are grouped by sections.", "schema": { "$ref": "#/definitions/CompanyDocumentsResult" }, "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/companies/{caseCommonId}/members": { "get": { "description": "Gets company case members. Know Your Customer application supports two types of cases:\n- Company case - a case created for company that should be verified;\n- Individual case - a case created for individual for verification against AML worldcheck database, government photo id, etc.\n\nBoth types of cases can be members of the parent company case (can be officers and/or shareholders).", "operationId": "59a71a2efe9cef13f4a647f4", "summary": "Company Members", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Company members structure.\n
\nAll returned member groups (controllingEntitiesAndIndividuals, shareholdersAndBeneficialOwners, personsWithSignifficantControl and ultimateBeneficialOwners) can include cases for individuals and companies.\nEach returned member group got title which is represented by controllingEntitiesAndIndividualsTitle, shareholdersAndBeneficialOwnersTitle, personsWithSignificantControlTitle and ultimateBeneficialOwnersTitle properties. These properties describe what kind of members the current group contains (\"Controlling Entities and Individuals\", \"Partners and Beneficial Owners\", \"Persons with Signifficant Control\", \"Ultimate Beneficial Owners\" etc).\n
\n\nEach member result object contains:\n- properties - object which can contain different set of data depending from jurisdiction and registry. Each registry provides different set of data.\n
Minimum dataset for company member: Company Name, Company Type,\n Company Registration Number, Company Status, Creation / Incorporation Date.\n
Minimum dataset for individual member: Individual Name, Individual Relation (Director | Secretary | Auditor | etc).\n\n- isCaseAMLPositive - True if the case contains at least one AML check not excluded. False otherwise;\n- isKYCed - indicates if the particular member can be processed and verified;\n- memberType - type of the member. Can be \"Company\" or \"Individual\".\n", "schema": { "$ref": "#/definitions/CaseMembersResult" }, "examples": { "application/json": { "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": null, "caseCommonId": null, "addressLine1": "38 C Søndre Alle", "addressLine2": null, "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "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": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "role": "Partner", "isCaseAMLPositive": false, "member": { "entityName": "AKTK ApS", "caseCommonId": 14151, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "12 Store Torvegade", "addressLine2": "", "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Store Torvegade 12, 3700 Rønne", "address": "12 Store Torvegade, Rønne, 3700, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "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": null, "caseCommonId": null, "addressLine1": "2 A Elses Løkkevej", "addressLine2": null, "city": "Nexø", "stateProvince": null, "postcode": "3730", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Elses Løkkevej 2 A , Snogebæk, 3730 Nexø, Denmark", "address": "2 A Elses Løkkevej, Nexø, 3730, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "role": "Partner", "isCaseAMLPositive": false, "member": { "firstName": "Ole", "lastName": "BONDERUP", "caseCommonId": 14153, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "1 Broløkke", "addressLine2": null, "city": "Svaneke", "stateProvince": null, "postcode": "3740", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Broløkke 1 , Østermarie, 3740 Svaneke, Denmark", "address": "1 Broløkke, Svaneke, 3740, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "role": "Partner", "isCaseAMLPositive": false, "member": { "firstName": "Anders", "lastName": "KOFOED", "caseCommonId": 14154, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "94 Aaker", "addressLine2": null, "city": "Aakirkeby", "stateProvince": null, "postcode": "3720", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Søndre Landevej 94 , Aaker, 3720 Aakirkeby, Denmark", "address": "94 Aaker, Aakirkeby, 3720, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "role": "Partner", "isCaseAMLPositive": false, "member": { "firstName": "Tonny", "lastName": "KOFOED", "caseCommonId": 14155, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "37 Kapelvej", "addressLine2": null, "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Kapelvej 37 , Rønne, 3700 Rønne, Denmark", "address": "37 Kapelvej, Rønne, 3700, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "role": "Director", "isCaseAMLPositive": false, "member": { "firstName": "Dan", "lastName": "Linddal Bechmann ANDERSEN", "caseCommonId": 14150, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "38 C Søndre Alle", "addressLine2": null, "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "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": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "role": "Director", "isCaseAMLPositive": false, "member": { "entityName": "AKTK ApS", "caseCommonId": 14151, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "12 Store Torvegade", "addressLine2": "", "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Store Torvegade 12, 3700 Rønne", "address": "12 Store Torvegade, Rønne, 3700, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "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": null, "caseCommonId": null, "addressLine1": "2 A Elses Løkkevej", "addressLine2": null, "city": "Nexø", "stateProvince": null, "postcode": "3730", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Elses Løkkevej 2 A , Snogebæk, 3730 Nexø, Denmark", "address": "2 A Elses Løkkevej, Nexø, 3730, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": false }, { "role": "Director", "isCaseAMLPositive": false, "member": { "firstName": "Ole", "lastName": "BONDERUP", "caseCommonId": 14153, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "1 Broløkke", "addressLine2": null, "city": "Svaneke", "stateProvince": null, "postcode": "3740", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Broløkke 1 , Østermarie, 3740 Svaneke, Denmark", "address": "1 Broløkke, Svaneke, 3740, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": false }, { "role": "Director", "isCaseAMLPositive": false, "member": { "firstName": "Anders", "lastName": "KOFOED", "caseCommonId": 14154, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "94 Aaker", "addressLine2": null, "city": "Aakirkeby", "stateProvince": null, "postcode": "3720", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Søndre Landevej 94 , Aaker, 3720 Aakirkeby, Denmark", "address": "94 Aaker, Aakirkeby, 3720, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": false }, { "role": "Director", "isCaseAMLPositive": false, "member": { "firstName": "Tonny", "lastName": "KOFOED", "caseCommonId": 14155, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "37 Kapelvej", "addressLine2": null, "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Kapelvej 37 , Rønne, 3700 Rønne, Denmark", "address": "37 Kapelvej, Rønne, 3700, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "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": null, "caseCommonId": null, "addressLine1": "94 Aaker", "addressLine2": null, "city": "Aakirkeby", "stateProvince": null, "postcode": "3720", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Søndre Landevej 94 , Aaker, 3720 Aakirkeby, Denmark", "address": "94 Aaker, Aakirkeby, 3720, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "shares": 27, "isCaseAMLPositive": false, "member": { "firstName": "Tonny", "lastName": "KOFOED", "caseCommonId": 14155, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "37 Kapelvej", "addressLine2": null, "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Kapelvej 37 , Rønne, 3700 Rønne, Denmark", "address": "37 Kapelvej, Rønne, 3700, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "shares": 0, "isCaseAMLPositive": false, "member": { "firstName": "Dan", "lastName": "Linddal Bechmann ANDERSEN", "caseCommonId": 14150, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "38 C Søndre Alle", "addressLine2": null, "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "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": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": false }, { "shares": 0, "isCaseAMLPositive": false, "member": { "entityName": "AKTK ApS", "caseCommonId": 14151, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "12 Store Torvegade", "addressLine2": "", "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Store Torvegade 12, 3700 Rønne", "address": "12 Store Torvegade, Rønne, 3700, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "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": null, "caseCommonId": null, "addressLine1": "2 A Elses Løkkevej", "addressLine2": null, "city": "Nexø", "stateProvince": null, "postcode": "3730", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Elses Løkkevej 2 A , Snogebæk, 3730 Nexø, Denmark", "address": "2 A Elses Løkkevej, Nexø, 3730, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": false }, { "shares": 0, "isCaseAMLPositive": false, "member": { "firstName": "Ole", "lastName": "BONDERUP", "caseCommonId": 14153, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "1 Broløkke", "addressLine2": null, "city": "Svaneke", "stateProvince": null, "postcode": "3740", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Broløkke 1 , Østermarie, 3740 Svaneke, Denmark", "address": "1 Broløkke, Svaneke, 3740, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": false } ], "ultimateBeneficialOwnersTitle": "Ultimate Beneficial Owners (UBO)", "ultimateBeneficialOwners": [ { "sharesPercentage": 27, "isCaseAMLPositive": false, "member": { "firstName": "Anders", "lastName": "KOFOED", "caseCommonId": 14154, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "94 Aaker", "addressLine2": null, "city": "Aakirkeby", "stateProvince": null, "postcode": "3720", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Søndre Landevej 94 , Aaker, 3720 Aakirkeby, Denmark", "address": "94 Aaker, Aakirkeby, 3720, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "sharesPercentage": 27, "isCaseAMLPositive": false, "member": { "firstName": "Tonny", "lastName": "KOFOED", "caseCommonId": 14155, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "37 Kapelvej", "addressLine2": null, "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Kapelvej 37 , Rønne, 3700 Rønne, Denmark", "address": "37 Kapelvej, Rønne, 3700, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true } ] } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/companies": { "post": { "description": "Creates a new company case", "operationId": "597b372afe9cef0db473970f", "summary": "Create Company Case", "parameters": [ { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "createCaseBody", "in": "body", "schema": { "$ref": "#/definitions/CreateCaseBody" }, "description": "Company data.\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
NameDescriptionMandatory
rawnameCompany nameYes
externalCodeCompany registration numberNo
codeiso31662Country ISO 3166-2 code. Should be empty for unknown jurisdictionYes
entityType\n Company type. Allowance values: Company,\n Partnership and Trust. (Obsolete, this parameter will be removed in the future.)\n Yes (for not automated jurisdictions)
journeyNameName of the journeyNo
companyType\n Company type. Allowance values: get from /companytypes\n Yes (for not automated jurisdictions)
unregisteredEntity\n Can take value true or false. When true, registry is not queried for information about this entity. Should be true for unknown jurisdiction\n No, false if not specified for known jurisdictions, true for unknown
caseProcessingType\n Case processing type. Allowance values: Empty string for regular processing, \"Lite\" for KYC lite case\n No (regular processing by default)
\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." } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Return created company case details:\n\ncommon - case common object:\n- caseCommonId - newly created company case identifier in Know Your Customer web application;\n- caseCustomerId - identifier of the company case for related customer;\n- type - case common type code.\n- typeString - case common type name. Text representation of the type. Can be \"Company\" or \"Individual\";\n- complete - indicates percentage of case automatic verification process completion;\n-edit - deprecated field;\n- status - current status of the company case, representing the case has been manually \nclosed by a user or not. Can be \"Open\" or \"Closed\";\n- statusId - representing current state of the case. Available status identifiers see in the table below.\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\n- isVisible - indicates if the company case is visible in Know Your Customer web \n- isAMLCase - indicates should we check on anti money laundering only or not;\n- countryRisk - anti money laundering country risk score;\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\n\ncompany - case company object:\n- caseCompanyId - company identifier in Know Your Customer web application;\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\n- type - type of business entity;\n- properties - object which can contain different set of data depending from jurisdiction and registry. Will be empty for this operation.\n\ncaseAddress - case address object:\n- caseAddressId - case address identifier in Know Your Customer web application;\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\n- rawAddress - address received from registry;\n- address - normalized address;\n\nAvailable case common status identifiers:\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

statusId

\n
\n

Meaning

\n
\n

Applies to what Cases

\n
\n

Description

\n
\n

0

\n
\n

Initializing

\n
\n

Companies and Individuals

\n
\n

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

\n
\n

1

\n
\n

Data Collection

\n
\n

Companies and Individuals

\n
\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

\n
\n

2

\n
\n

Data Verification

\n
\n

\n

Companies and Individuals

\n

\n
\n

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

\n
\n

3

\n
\n

Ready

\n
\n

Companies and Individuals

\n\n
\n

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

\n
\n

4-49

\n
\n

Reserved

\n
\n

Companies and Individuals

\n
\n

-

\n
\n

50

\n
\n

RetrievingBasicData

\n
\n

Companies

\n
\n

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

\n
\n

51

\n
\n

IdentifyingControllingEntities

\n
\n

Companies

\n
\n

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

\n
\n

52

\n
\n

RetrievingExtendedData

\n
\n

Companies

\n
\n

Retrieving extended company data, if available

\n
\n

53

\n
\n

DownloadingCompanyDocuments

\n
\n

Companies

\n
\n

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

\n
\n

54

\n
\n

IdentifyingBeneficialOwners

\n
\n

Companies

\n
\n

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

\n
\n

55

\n
\n

PreparingChildren

\n
\n

Companies

\n
\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)

\n
\n

56

\n
\n

CheckingListedEntities

\n
\n

Companies

\n
\n

Checking for market listed entities

\n
\n

57-99

\n
\n

Reserved

\n
\n

Companies

\n
\n\n

 

\n
\n

100

\n
\n

PerformingAmlChecks

\n
\n

Individuals

\n
\n

Performing Individual AML Checks

\n
\n

101

\n
\n

PerformingAddressChecks

\n
\n

Individuals

\n
\n

Performing Individual Address Checks in available Jurisdictions

\n
\n

102

\n
\n

PerformingCourtChecks

\n
\n

Individuals

\n
\n

Performing Individual Courts Data Checks in available Jurisdictions

\n
\n

103-150

\n
\n

Reserved

\n
\n

Individuals

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

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

statusId

\n
\n

Meaning

\n
\n

Applies to what Cases

\n
\n

Description

\n
\n

0

\n
\n

Initializing

\n
\n

Companies and Individuals

\n
\n

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

\n
\n

1

\n
\n

Data Collection

\n
\n

Companies and Individuals

\n
\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

\n
\n

2

\n
\n

Data Verification

\n
\n

\n

Companies and Individuals

\n

\n
\n

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

\n
\n

3

\n
\n

Ready

\n
\n

Companies and Individuals

\n\n
\n

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

\n
\n

4-49

\n
\n

Reserved

\n
\n

Companies and Individuals

\n
\n

-

\n
\n

50

\n
\n

RetrievingBasicData

\n
\n

Companies

\n
\n

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

\n
\n

51

\n
\n

IdentifyingControllingEntities

\n
\n

Companies

\n
\n

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

\n
\n

52

\n
\n

RetrievingExtendedData

\n
\n

Companies

\n
\n

Retrieving extended company data, if available

\n
\n

53

\n
\n

DownloadingCompanyDocuments

\n
\n

Companies

\n
\n

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

\n
\n

54

\n
\n

IdentifyingBeneficialOwners

\n
\n

Companies

\n
\n

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

\n
\n

55

\n
\n

PreparingChildren

\n
\n

Companies

\n
\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)

\n
\n

56

\n
\n

CheckingListedEntities

\n
\n

Companies

\n
\n

Checking for market listed entities

\n
\n

57-99

\n
\n

Reserved

\n
\n

Companies

\n
\n\n

 

\n
\n

100

\n
\n

PerformingAmlChecks

\n
\n

Individuals

\n
\n

Performing Individual AML Checks

\n
\n

101

\n
\n

PerformingAddressChecks

\n
\n

Individuals

\n
\n

Performing Individual Address Checks in available Jurisdictions

\n
\n

102

\n
\n

PerformingCourtChecks

\n
\n

Individuals

\n
\n

Performing Individual Courts Data Checks in available Jurisdictions

\n
\n

103-150

\n
\n

Reserved

\n
\n

Individuals

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n", "schema": { "$ref": "#/definitions/CompaniesList" }, "examples": { "application/json": "[{\n\t\"common\": {\n \"caseCommonId\": 7839,\n \"caseCustomerId\": 677,\n \"customerId\": 224,\n \"customerName\": \"YourCustomer\",\n \"type\": 1,\n \"typeString\": \"Company\",\n \"scoring\": 0,\n \"complete\": 55,\n \"edit\": true,\n \"status\": \"Open\",\n \"statusChangedDatetime\": null,\n \"statusChangedBy\": null,\n \"statusId\": 3,\n \"caseDecision\": \"Accepted\",\n \"isVisible\": true,\n \"creatorId\": \"db557fed-99b5-4c8a-b3c9-5d2d42d2bc13\",\n \"creatorUserName\": \"example@example.com\",\n \"createdDatetime\": \"2017-09-26T05:22:52.847\",\n \"updatedBySystem\": \"2017-09-26T05:26:11.41\",\n \"isAMLCase\": false,\n \"updatedByUser\": null,\n \"customerDepartmentId\": 1249,\n \"customerDepartmentName\": \"Management\",\n \"countryRisk\": 5.51,\n \"assignedUserId\": null,\n \"assignedUserName\": null,\n \"link\": \"https://app.knowyourcustomer.com/casecompany/7839/detail\",\n \"isComplexStructure\": true,\n \"caseDrillDownLevel\": 2\n },\n \"isCaseAMLPositive\": true,\n \"company\": {\n \"id\": 3080,\n \"caseCompanyId\": 3080,\n \"caseCommonId\": 7839,\n \"countryCodeISO31662\": \"HK\",\n \"entityName\": \"HKTC Corporate Services Limited\",\n \"type\": \"Private company limited by shares\",\n \"description\": \"Checking for Company Situation\",\n \"userId\": \"db557fed-99b5-4c8a-b3c9-5d2d42d2bc13\",\n \"creatorId\": \"db557fed-99b5-4c8a-b3c9-5d2d42d2bc13\",\n \"createdDatetime\": \"2017-09-26T05:22:52.893\",\n \"properties\": {\n \"Company Status\": \"Active\",\n \"Company Type\": \"Private company limited by shares\",\n \"Incorporation Date\": \"16/08/2012\",\n \"Other Names\": \"香港企業諮詢服務有限公司\"\n }\n },\n \"caseAddress\": {\n \"caseAddressId\": 7792,\n \"caseCommonId\": 7839,\n \"addressLine1\": \"40-44 Wyndham Place Wyndham Street Central\",\n \"addressLine2\": \"\",\n \"city\": \"Hong Kong\",\n \"stateProvince\": null,\n \"postcode\": null,\n \"country\": \"Hong kong\",\n \"countryCodeISO31662\": \"HK\",\n \"countryId\": 3,\n \"rawAddress\": \"6/F., WYNDHAM PLACE,40-44 WYNDHAM STREET, CENTRAL, HONG KONG, HONG KONG\",\n \"address\": \"40-44 Wyndham Place Wyndham Street Central, Hong Kong, Hong kong\",\n \"userId\": \"db557fed-99b5-4c8a-b3c9-5d2d42d2bc13\",\n \"creatorName\": \"example@example.com\",\n \"createdDatetime\": \"2017-09-26T05:22:52.893\"\n }\n}]\n" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/documents/{documentId}": { "get": { "description": "Download Document", "operationId": "597b372afe9cef0db4739711", "summary": "Download Document", "parameters": [ { "name": "documentId", "in": "path", "description": "Document id", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Document data" }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "statusCode": 401, "message": "Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API." } } } }, "produces": [ "application/json" ] } }, "/jurisdictions": { "get": { "description": "Get available jurisdictions", "operationId": "597b372afe9cef0db473970e", "summary": "Jurisdictions", "parameters": [ { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns list of the available jurisdictions", "schema": { "$ref": "#/definitions/JurisdictionsResult" }, "examples": { "application/json": { "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 }, { "name": "Unknown", "codeiso31662": "None", "area": "Unknown", "isautomated": false } ] } } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid API Key", "timeStamp": "7/28/2017 2:15:51 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/companies/search": { "post": { "description": "Executes companies search in the registry of the specified jurisdiciton based on:\n- country code defined in ISO 3166-2 standard;\n- search query (full or partial company name or company registration number).\n\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", "summary": "Search Companies", "parameters": [ { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "caseSearchBody", "in": "body", "schema": { "$ref": "#/definitions/CaseSearchBody" }, "description": "Parameters definition:\n- codeiso31662 - jurisdiction's country code defined in ISO 3166-2 standard;\n- query - full or partial name or registration number of the company you are looking for." } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Returns companies list based on search criteria:\n- rawname - actual company name or trade name provided by registry site;\n- externalCode - company registration number provided by registry site;\n- rawAddress - company address provided by registry site;\n- companyStatus - company status provided by registry site.", "schema": { "$ref": "#/definitions/CompaniesSearchResult" }, "examples": { "application/json": { "companySearch": { "results": [ { "rawname": "TEST AIR SERVICES LTD", "externalCode": "06650586", "rawAddress": "96 96 Pelhurst Road, Ryde, Isle Of Wight, England", "companyStatus": "Active" }, { "rawname": "TEST AIR SOLUTIONS LIMITED", "externalCode": "05661420", "rawAddress": "225 Market Street, Hyde, Cheshire, SK14 1HF", "companyStatus": "Active" } ] } } } }, "400": { "description": "Invalid request parameters. Errors descriptions:\n- Invalid Jurisdiction - provided jurisdiction is not automated yet. You cannot perform companies search for not automated jurisdictions.", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid Jurisdiction", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/version": { "get": { "description": "Get current API version.", "operationId": "597b3729fe9cef0db473970b", "summary": "Version", "parameters": [ { "name": "ApiKey", "in": "header", "required": true, "type": "string" } ], "responses": { "200": { "description": "Success", "examples": { "application/json": "\"2.0.1.23013\"" } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "statusCode": 401, "message": "Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API." } } } }, "produces": [ "application/json" ] } }, "/individuals": { "post": { "description": "Creates a new individual case", "operationId": "5a181acf1257bc13c421bd17", "summary": "Create Individual Case", "parameters": [ { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "createIndividualCaseBody", "in": "body", "schema": { "$ref": "#/definitions/CreateIndividualCaseBody" }, "description": "Individual data.\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n \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
" } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Return created individual case details:\n\ncommon - case common object:\n- caseCommonId - individual case identifier in Know Your Customer web application;\n- caseCustomerId - identifier of the individual case for related customer;\n- type - case common type code.\n- typeString - case common type name. Text representation of the type;\n- complete - indicates percentage of case automatic verification process completion;\n- edit - deprecated field;\n- status - current status of the individual case, representing the case has been manually \nclosed by a user or not. Can be \"Open\" or \"Closed\";\n- statusId - representing current state of the case. Available status identifiers see in the table below.\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\n- isVisible - indicates if the individual case is visible in Know Your Customer web \n- isAMLCase - indicates should we check on anti money laundering only or not;\n- countryRisk - anti money laundering country risk score;\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\n\nindividual - case individual object:\n- caseIndividualId - individual identifier in Know Your Customer web application;\n- firstName - individual's first name;\n- lastName - individual's last name;\n- countryCodeISO31662 - country code of individual case defined in ISO 3166-2 standard;\n- nationalityCodeISO31662 - country code of the nationality defined in ISO 3166-2 standard;\n- properties - object which can contain different set of data like Date of Birth, Occupdation, etc;\n\ncaseAddress - case address object:\n- caseAddressId - case address identifier in Know Your Customer web application;\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\n- rawAddress - address received from registry;\n- address - normalized address;\n\nAvailable case common status identifiers:\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

statusId

\n
\n

Meaning

\n
\n

Applies to what Cases

\n
\n

Description

\n
\n

0

\n
\n

Initializing

\n
\n

Companies and Individuals

\n
\n

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

\n
\n

1

\n
\n

Data Collection

\n
\n

Companies and Individuals

\n
\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

\n
\n

2

\n
\n

Data Verification

\n
\n

\n

Companies and Individuals

\n

\n
\n

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

\n
\n

3

\n
\n

Ready

\n
\n

Companies and Individuals

\n\n
\n

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

\n
\n

4-49

\n
\n

Reserved

\n
\n

Companies and Individuals

\n
\n

-

\n
\n

50

\n
\n

RetrievingBasicData

\n
\n

Companies

\n
\n

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

\n
\n

51

\n
\n

IdentifyingControllingEntities

\n
\n

Companies

\n
\n

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

\n
\n

52

\n
\n

RetrievingExtendedData

\n
\n

Companies

\n
\n

Retrieving extended company data, if available

\n
\n

53

\n
\n

DownloadingCompanyDocuments

\n
\n

Companies

\n
\n

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

\n
\n

54

\n
\n

IdentifyingBeneficialOwners

\n
\n

Companies

\n
\n

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

\n
\n

55

\n
\n

PreparingChildren

\n
\n

Companies

\n
\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)

\n
\n

56

\n
\n

CheckingListedEntities

\n
\n

Companies

\n
\n

Checking for market listed entities

\n
\n

57-99

\n
\n

Reserved

\n
\n

Companies

\n
\n\n

 

\n
\n

100

\n
\n

PerformingAmlChecks

\n
\n

Individuals

\n
\n

Performing Individual AML Checks

\n
\n

101

\n
\n

PerformingAddressChecks

\n
\n

Individuals

\n
\n

Performing Individual Address Checks in available Jurisdictions

\n
\n

102

\n
\n

PerformingCourtChecks

\n
\n

Individuals

\n
\n

Performing Individual Courts Data Checks in available Jurisdictions

\n
\n

103-150

\n
\n

Reserved

\n
\n

Individuals

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
", "schema": { "$ref": "#/definitions/IndividualCaseDetailResult" }, "examples": { "application/json": { "caseDetail": { "details": { "individual": { "caseIndividualId": 8905, "firstName": "John", "lastName": "Doe", "countryCodeISO31662": "PT", "country": "Portugal", "email": null, "phone": null, "nationalityCountryCodeISO31662": "GB", "nationalityCountry": "United kingdom", "caseCommonId": 14050, "creatorId": "db557fed-99b5-4c8a-b3c9-5d2d42d2bc13", "properties": { "Birth Date": "01/01/1990" }, "createdDatetime": "2017-11-24T11:44:17.22" }, "common": { "caseCommonId": 14069, "caseCustomerId": 1165, "customerId": 224, "customerName": "AndreiCo", "type": 2, "typeString": "Individual", "scoring": 0, "complete": 0, "edit": true, "status": "Open", "statusChangedDatetime": null, "statusChangedBy": null, "statusId": null, "caseDecision": null, "isVisible": true, "creatorId": "db557fed-99b5-4c8a-b3c9-5d2d42d2bc13", "creatorUserName": "avgybarev@gmail.com", "createdDatetime": "2017-11-24T13:41:58.03", "updatedBySystem": null, "isAMLCase": null, "updatedByUser": null, "customerDepartmentId": 1249, "customerDepartmentName": "Management", "countryRisk": 4.77, "assignedUserId": null, "assignedUserName": null, "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": null, "postcode": null, "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.893" } } } } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Internal Error", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] }, "get": { "description": "Gets individuals list", "operationId": "5bdacf5a13f9403fd9df848b", "summary": "Individuals", "parameters": [ { "name": "createdDateFrom", "in": "query", "description": "Start time at which the case was created in ISO 8601 format (YYYY-MM-DDThh:mm:ss)", "type": "string" }, { "name": "createdDateTo", "in": "query", "description": "End time at which the case was created in ISO 8601 format (YYYY-MM-DDThh:mm:ss)", "type": "string" }, { "name": "countryCodeIso31662", "in": "query", "description": "ISO 31662 country code for which the cases should belong", "type": "string" }, { "name": "pageSize", "in": "query", "description": "Size of the page", "type": "string" }, { "name": "pageNumber", "in": "query", "description": "Page number", "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns list of individual cases.\n\ncommon - case common object:\n- caseCommonId - individual case identifier in Know Your Customer web application;\n- caseCustomerId - identifier of the individual case for related customer;\n- type - case common type code.\n- typeString - case common type name. Text representation of the type;\n- complete - indicates percentage of case automatic verification process completion;\n- edit - deprecated field;\n- status - current status of the individual case, representing the case has been manually \nclosed by a user or not. Can be \"Open\" or \"Closed\";\n- statusId - representing current state of the case. Available status identifiers see in the table below.\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\n- isVisible - indicates if the individual case is visible in Know Your Customer web \n- isAMLCase - indicates should we check on anti money laundering only or not;\n- countryRisk - anti money laundering country risk score;\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\n\nisCaseAMLPositive - True if the case contains at least one AML check not excluded. False otherwise\n\nindividual - case individual object:\n- caseIndividualId - individual identifier in Know Your Customer web application;\n- firstName - individual's first name;\n- lastName - individual's last name;\n- countryCodeISO31662 - country code of individual case defined in ISO 3166-2 standard;\n- nationalityCodeISO31662 - country code of the nationality defined in ISO 3166-2 standard;\n- properties - object which can contain different set of data like Date of Birth, Occupdation, etc;\n\ncaseAddress - case address object:\n- caseAddressId - case address identifier in Know Your Customer web application;\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\n- rawAddress - address received from registry;\n- address - normalized address;\n\nAvailable case common status identifiers:\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

statusId

\n
\n

Meaning

\n
\n

Applies to what Cases

\n
\n

Description

\n
\n

0

\n
\n

Initializing

\n
\n

Companies and Individuals

\n
\n

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

\n
\n

1

\n
\n

Data Collection

\n
\n

Companies and Individuals

\n
\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

\n
\n

2

\n
\n

Data Verification

\n
\n

\n

Companies and Individuals

\n

\n
\n

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

\n
\n

3

\n
\n

Ready

\n
\n

Companies and Individuals

\n\n
\n

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

\n
\n

4-49

\n
\n

Reserved

\n
\n

Companies and Individuals

\n
\n

-

\n
\n

50

\n
\n

RetrievingBasicData

\n
\n

Companies

\n
\n

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

\n
\n

51

\n
\n

IdentifyingControllingEntities

\n
\n

Companies

\n
\n

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

\n
\n

52

\n
\n

RetrievingExtendedData

\n
\n

Companies

\n
\n

Retrieving extended company data, if available

\n
\n

53

\n
\n

DownloadingCompanyDocuments

\n
\n

Companies

\n
\n

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

\n
\n

54

\n
\n

IdentifyingBeneficialOwners

\n
\n

Companies

\n
\n

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

\n
\n

55

\n
\n

PreparingChildren

\n
\n

Companies

\n
\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)

\n
\n

56

\n
\n

CheckingListedEntities

\n
\n

Companies

\n
\n

Checking for market listed entities

\n
\n

57-99

\n
\n

Reserved

\n
\n

Companies

\n
\n\n

 

\n
\n

100

\n
\n

PerformingAmlChecks

\n
\n

Individuals

\n
\n

Performing Individual AML Checks

\n
\n

101

\n
\n

PerformingAddressChecks

\n
\n

Individuals

\n
\n

Performing Individual Address Checks in available Jurisdictions

\n
\n

102

\n
\n

PerformingCourtChecks

\n
\n

Individuals

\n
\n

Performing Individual Courts Data Checks in available Jurisdictions

\n
\n

103-150

\n
\n

Reserved

\n
\n

Individuals

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

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

statusId

\n
\n

Meaning

\n
\n

Applies to what Cases

\n
\n

Description

\n
\n

0

\n
\n

Initializing

\n
\n

Companies and Individuals

\n
\n

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

\n
\n

1

\n
\n

Data Collection

\n
\n

Companies and Individuals

\n
\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

\n
\n

2

\n
\n

Data Verification

\n
\n

\n

Companies and Individuals

\n

\n
\n

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

\n
\n

3

\n
\n

Ready

\n
\n

Companies and Individuals

\n\n
\n

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

\n
\n

4-49

\n
\n

Reserved

\n
\n

Companies and Individuals

\n
\n

-

\n
\n

50

\n
\n

RetrievingBasicData

\n
\n

Companies

\n
\n

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

\n
\n

51

\n
\n

IdentifyingControllingEntities

\n
\n

Companies

\n
\n

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

\n
\n

52

\n
\n

RetrievingExtendedData

\n
\n

Companies

\n
\n

Retrieving extended company data, if available

\n
\n

53

\n
\n

DownloadingCompanyDocuments

\n
\n

Companies

\n
\n

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

\n
\n

54

\n
\n

IdentifyingBeneficialOwners

\n
\n

Companies

\n
\n

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

\n
\n

55

\n
\n

PreparingChildren

\n
\n

Companies

\n
\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)

\n
\n

56

\n
\n

CheckingListedEntities

\n
\n

Companies

\n
\n

Checking for market listed entities

\n
\n

57-99

\n
\n

Reserved

\n
\n

Companies

\n
\n\n

 

\n
\n

100

\n
\n

PerformingAmlChecks

\n
\n

Individuals

\n
\n

Performing Individual AML Checks

\n
\n

101

\n
\n

PerformingAddressChecks

\n
\n

Individuals

\n
\n

Performing Individual Address Checks in available Jurisdictions

\n
\n

102

\n
\n

PerformingCourtChecks

\n
\n

Individuals

\n
\n

Performing Individual Courts Data Checks in available Jurisdictions

\n
\n

103-150

\n
\n

Reserved

\n
\n

Individuals

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n", "schema": { "$ref": "#/definitions/IndividualCaseDetailResult" }, "examples": { "application/json": { "caseDetail": { "details": { "individual": { "caseIndividualId": 8905, "firstName": "John", "lastName": "Doe", "countryCodeISO31662": "PT", "country": "Portugal", "email": null, "phone": null, "nationalityCountryCodeISO31662": "GB", "nationalityCountry": "United kingdom", "caseCommonId": 14050, "creatorId": "db557fed-99b5-4c8a-b3c9-5d2d42d2bc13", "properties": { "Birth Date": "01/01/1990" }, "createdDatetime": "2017-11-24T11:44:17.22" }, "isCaseAMLPositive": true, "common": { "caseCommonId": 14069, "caseCustomerId": 1165, "customerId": 224, "customerName": "AndreiCo", "type": 2, "typeString": "Individual", "scoring": 0, "complete": 0, "edit": true, "status": "Open", "statusChangedDatetime": null, "statusChangedBy": null, "statusId": null, "caseDecision": "Accepted", "isVisible": true, "creatorId": "db557fed-99b5-4c8a-b3c9-5d2d42d2bc13", "creatorUserName": "avgybarev@gmail.com", "createdDatetime": "2017-11-24T13:41:58.03", "updatedBySystem": null, "isAMLCase": null, "updatedByUser": null, "customerDepartmentId": 1249, "customerDepartmentName": "Management", "countryRisk": 4.77, "assignedUserId": null, "assignedUserName": null, "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": null, "postcode": null, "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.893", "deviceLng": -10.1248091, "deviceLat": 41.4994791, "geolocationVerified": "Verification successful" } } } } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] }, "delete": { "description": "Removes individual case ", "operationId": "5cdbba1256b01802c059d487", "summary": "Remove Individual Case", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case common identifier", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Success message", "schema": { "$ref": "#/definitions/" }, "examples": { "application/json": { "message": "Case deleted successfully" } } }, "400": { "description": "Invalid request parameters / Access denied", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid request: Delete case: access denied.", "timeStamp": "5/15/2019 7:35:39 AM" } ] } } } }, "produces": [ "application/json" ] } }, "/companies/{caseCommonId}/properties": { "post": { "description": "Creates new company case properties or update existing with same data type and returns array of existing company case properties", "operationId": "5a421c561257bc0ca8459627", "summary": "Create/Update Company Case Properties", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "casePropertiesArrayBodyCompanies", "in": "body", "schema": { "$ref": "#/definitions/CasePropertiesArrayBodyCompanies" }, "description": "Body should contain array of case properties you want to create/update. Case property object contains:\n- dataType - case property data type;\n- data - case property data.\n\nYou can create case property with data type existing in the system or new one.\n\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." } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Return all case properties for particular company case.", "schema": { "$ref": "#/definitions/CasePropertiesArrayResult" }, "examples": { "application/json": "[\n {\n \"dataType\": \"Activity Type\",\n \"data\": \"Any type\"\n },\n {\n \"dataType\": \"Other Names\",\n \"data\": \"Test Limited\"\n }\n]" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] }, "get": { "description": "Gets company case properties", "operationId": "5a4219cf1257bc0ca8459625", "summary": "Get Company Case Properties", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns array of company case properties.", "schema": { "$ref": "#/definitions/CasePropertiesArrayResult" }, "examples": { "application/json": "[\n {\n \"dataType\": \"Other Names\",\n \"data\": \"Test Company Limited\"\n }\n]" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/individuals/{caseCommonId}/properties": { "post": { "description": "Creates new individual case properties or update existing with same data type and returns array of existing individual case properties", "operationId": "5a4220901257bc0ca8459628", "summary": "Create/Update Individual Case Properties", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "casePropertiesArrayBodyIndividual", "in": "body", "schema": { "$ref": "#/definitions/CasePropertiesArrayBodyIndividual" }, "description": "Body should contain array of case properties you want to create/update. Case property object contains:\n- dataType - case property data type;\n- data - case property data.\n\nYou can create case property with data type existing in the system or new one.\n\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." } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Return all case properties for particular individual case.", "schema": { "$ref": "#/definitions/CasePropertiesArrayResult" }, "examples": { "application/json": "[\n {\n \"dataType\": \"Birth Date\",\n \"data\": \"01/01/2000\"\n }\n]" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] }, "get": { "description": "Gets individual case properties", "operationId": "5a421b361257bc0ca8459626", "summary": "Get Individual Case Properties", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns array of individual case properties.", "schema": { "$ref": "#/definitions/CasePropertiesArrayResult" }, "examples": { "application/json": "[\n {\n \"dataType\": \"Birth Date\",\n \"data\": \"01/01/2000\"\n }\n]" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/properties/dataTypes": { "get": { "description": "Gets distinct data types of case properties existing in the system.", "operationId": "5a4215061257bc0ca8459623", "summary": "Get Data Types", "parameters": [ { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Return distinct datatypes of case properties existing in the system that could be used to create new properties records.", "schema": { "$ref": "#/definitions/DataTypesResult" }, "examples": { "application/json": "[\n \"Birth Date\",\n \"Nationality\",\n \"Creation Date\",\n \"Activity Type\",\n \"Company Status\",\n \"Company Type\",\n \"Appointed on\",\n \"Occupations\",\n \"Registration Number\",\n \"Incorporation Date\",\n \"Last Accounts Date\",\n \"Next Accounts Date\",\n \"Records Date\",\n \"Date of Incorporation\",\n \"Dissolution Date\",\n \"Other Names\",\n \"National Country ID \",\n \"Passport Country\",\n \"Passport Number\",\n \"National Country ID\",\n \"Postal Code\",\n \"TradeMark\",\n \"Phone\",\n \"VAT\",\n \"USA State\",\n \"Email\",\n \"ID / Registration Number\",\n \"Name\",\n \"Fax Number\",\n \"Identity Type\",\n \"Capital\",\n \"Law\",\n \"Other Identifers\",\n \"Total Share Capital\",\n \"Other Identifiers\"\n]" } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/companies/{caseCommonId}/documents/mandatory": { "get": { "description": "Gets mandatory documents for company case", "operationId": "5a4cf0191257bc0f544bda4f", "summary": "Get Mandatory Documents For Company Case", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns array mandatory documents categories", "schema": { "$ref": "#/definitions/DocumentCategories" }, "examples": { "application/json": "[\n \"NEWINC\"\n]" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/individuals/{caseCommonId}/documents/mandatory": { "get": { "description": "Gets mandatory documents for individual case", "operationId": "5a4cf3c01257bc0f544bda50", "summary": "Get Mandatory Documents For Individual Case", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns array mandatory documents categories", "schema": { "$ref": "#/definitions/DocumentCategories" }, "examples": { "application/json": "[\n \"photoid\"\n]" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/companies/import": { "post": { "description": "Imports company case", "operationId": "5a5861341257bc0aa819a424", "summary": "Import Company Case", "parameters": [ { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "importCompanyCaseBody", "in": "body", "schema": { "$ref": "#/definitions/ImportCompanyCaseBody" }, "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:

\nentityName - the company name. Optional field;
\ncodeiso31662 - country ISO 3166-2 code. Optional field;
\ncompanyType - the company type. See possible values in the list below. Optional field;
\nproperties - array of the company properties, has same request body structure as described on POST /companies/caseCommonId/properties endpoint. Optional field;
\njourneyName - Name of the journey. Optional field;
\naddress - the object described company address. Mandatory field
\naddress can include the following properties:\n\n \n \n \n \n \n \n \n \n\t\n \n \n \n \n\t\n \n \n \n \n\t\n \n \n \n \n\t\n \n \n \n \n\t\n \n \n \n \n\t\n \n \n \n \n\t\n \n \n \n \n\t\n \n \n \n \n \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
\n\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.\n\nPossible company types:\n" } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Return imported company case details:\n\ncommon - case common object:\n- caseCommonId - newly created company case identifier in Know Your Customer web application;\n- caseCustomerId - identifier of the company case for related customer;\n- type - case common type code.\n- typeString - case common type name. Text representation of the type. Can be \"Company\" or \"Individual\";\n- complete - indicates percentage of case automatic verification process completion;\n-edit - deprecated field;\n- status - current status of the company case, representing the case has been manually \nclosed by a user or not. Can be \"Open\" or \"Closed\";\n- statusId - representing current state of the case. Available status identifiers see in the table below.\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\n- isVisible - indicates if the company case is visible in Know Your Customer web \n- isAMLCase - indicates should we check on anti money laundering only or not;\n- countryRisk - anti money laundering country risk score;\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\n\ncompany - case company object:\n- caseCompanyId - company identifier in Know Your Customer web application;\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\n- type - type of business entity;\n- properties - object which can contain different set of data depending from jurisdiction and registry. Will be empty for this operation.\n\ncaseAddress - case address object:\n- caseAddressId - case address identifier in Know Your Customer web application;\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\n- rawAddress - address received from registry;\n- address - normalized address;\n\nAvailable case common status identifiers:\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

statusId

\n
\n

Meaning

\n
\n

Applies to what Cases

\n
\n

Description

\n
\n

0

\n
\n

Initializing

\n
\n

Companies and Individuals

\n
\n

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

\n
\n

1

\n
\n

Data Collection

\n
\n

Companies and Individuals

\n
\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

\n
\n

2

\n
\n

Data Verification

\n
\n

\n

Companies and Individuals

\n

\n
\n

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

\n
\n

3

\n
\n

Ready

\n
\n

Companies and Individuals

\n\n
\n

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

\n
\n

4-49

\n
\n

Reserved

\n
\n

Companies and Individuals

\n
\n

-

\n
\n

50

\n
\n

RetrievingBasicData

\n
\n

Companies

\n
\n

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

\n
\n

51

\n
\n

IdentifyingControllingEntities

\n
\n

Companies

\n
\n

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

\n
\n

52

\n
\n

RetrievingExtendedData

\n
\n

Companies

\n
\n

Retrieving extended company data, if available

\n
\n

53

\n
\n

DownloadingCompanyDocuments

\n
\n

Companies

\n
\n

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

\n
\n

54

\n
\n

IdentifyingBeneficialOwners

\n
\n

Companies

\n
\n

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

\n
\n

55

\n
\n

PreparingChildren

\n
\n

Companies

\n
\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)

\n
\n

56

\n
\n

CheckingListedEntities

\n
\n

Companies

\n
\n

Checking for market listed entities

\n
\n

57-99

\n
\n

Reserved

\n
\n

Companies

\n
\n\n

 

\n
\n

100

\n
\n

PerformingAmlChecks

\n
\n

Individuals

\n
\n

Performing Individual AML Checks

\n
\n

101

\n
\n

PerformingAddressChecks

\n
\n

Individuals

\n
\n

Performing Individual Address Checks in available Jurisdictions

\n
\n

102

\n
\n

PerformingCourtChecks

\n
\n

Individuals

\n
\n

Performing Individual Courts Data Checks in available Jurisdictions

\n
\n

103-150

\n
\n

Reserved

\n
\n

Individuals

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
", "schema": { "$ref": "#/definitions/CaseDetailImportResult" }, "examples": { "application/json": { "details": { "common": { "caseCommonId": 10001, "caseCustomerId": 889, "customerId": 224, "customerName": "YourCustomer", "type": 1, "typeString": "Company", "scoring": 0, "complete": 0, "edit": true, "status": "Open", "statusChangedDatetime": null, "statusChangedBy": null, "statusId": 0, "caseDecision": null, "isVisible": true, "creatorId": "db557fed-99b5-4c8a-b3c9-5d2d42d2bc13", "creatorUserName": "example@example.com", "createdDatetime": "2017-10-20T21:30:53.863", "updatedBySystem": null, "isAMLCase": false, "updatedByUser": null, "customerDepartmentId": 1249, "customerDepartmentName": "Management", "countryRisk": 4.77, "assignedUserId": null, "assignedUserName": null, "link": "https://app.knowyourcustomer.com/casecompany/10001/detail" }, "company": { "id": 3777, "caseCompanyId": 3777, "caseCommonId": 10001, "countryCodeISO31662": "GB", "entityName": "TEST AIR SERVICES LTD", "type": null, "description": "Case Generated from API2", "userId": "db557fed-99b5-4c8a-b3c9-5d2d42d2bc13", "creatorId": "db557fed-99b5-4c8a-b3c9-5d2d42d2bc13", "createdDatetime": "2017-10-20T21:30:54.09", "properties": {} }, "caseAddress": { "caseAddressId": 9950, "caseCommonId": 10001, "addressLine1": null, "addressLine2": null, "city": null, "stateProvince": null, "postcode": null, "country": null, "countryCodeISO31662": null, "countryId": null, "rawAddress": null, "address": null, "userId": null, "creatorName": null, "createdDatetime": "2017-10-20T21:30:54.093" } } } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Internal Error", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/individuals/{caseCommonId}/documents": { "get": { "description": "Gets individual documents", "operationId": "5a7c2edf1257bc18dcd6b71b", "summary": "Individual Documents", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Return array of individual documents.", "schema": { "$ref": "#/definitions/IndividualDocumentsResult" }, "examples": { "application/json": "[\n {\n \"caseDocumentId\": 227841,\n \"category\": \"selfie\",\n \"name\": \"Selfie\",\n \"link\": \"https://kyc.azure-api.net/v2/documents/227841\"\n },\n {\n \"caseDocumentId\": 227840,\n \"category\": \"photoid\",\n \"name\": \"Photo ID\",\n \"link\": \"https://kyc.azure-api.net/v2/documents/227840\"\n },\n {\n \"caseDocumentId\": 227842,\n \"category\": \"poa\",\n \"name\": \"Address\",\n \"link\": \"https://kyc.azure-api.net/v2/documents/227842\"\n }\n]" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "403": { "description": "Access denied", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/companies/{caseCommonId}/link/{childCaseCommonId}": { "post": { "description": "Links child case to parent company case", "operationId": "5a7c75371257bc18dcd6b71c", "summary": "Link Case To Company", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "childCaseCommonId", "in": "path", "description": "Child Case Common identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "linkCaseToCompanyBody", "in": "body", "schema": { "$ref": "#/definitions/LinkCaseToCompanyBody" }, "description": "Object describes what type of relation should be created between child case and parent company:\n\nrelationType - relation type. Possible values described in the table below;\n\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;\nNatureOfControl - mandatory field\nNotifiedOn - optional, user is able to supply Notified On date value when linking the case\n\nshares - In case if relationType is Shareholder you can provide amount of shares.\n\n\nPossible relationType values:\n\n \n \n \n \n \n \n \n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n \n\t\t\t\n\t\t\t\n\t\t\n \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
OtherIndividualOther Individual
" } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Company members structure.\n
\nAll returned member groups (controllingEntitiesAndIndividuals, personsWithSignifficantControl and shareholdersAndBeneficialOwners) can include cases for individuals and companies.\nEach returned member group got title which is represented by controllingEntitiesAndIndividualsTitle, personsWithSignifficantControlTitle and shareholdersAndBeneficialOwnersTitle properties. These properties describe what kind of members the current group contains (\"Controlling Entities and Individuals\", \"Partners and Beneficial Owners\", etc).\n
\n\nEach member result object contains:\n- properties - object which can contain different set of data depending from jurisdiction and registry. Each registry provides different set of data.\n
Minimum dataset for company member: Company Name, Company Type,\n Company Registration Number, Company Status, Creation / Incorporation Date.\n
Minimum dataset for individual member: Individual Name, Individual Relation (Director | Secretary | Auditor | etc).\n\n- isKYCed - indicates if the particular member can be processed and verified;\n- memberType - type of the member. Can be \"Company\" or \"Individual\".", "schema": { "$ref": "#/definitions/CaseMembersResult" }, "examples": { "application/json": { "controllingEntitiesAndIndividualsTitle": "Controlling Entities and Individuals", "controllingEntitiesAndIndividuals": [ { "role": "Partner", "member": { "firstName": "Dan", "lastName": "Linddal Bechmann ANDERSEN", "caseCommonId": 14150, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "38 C Søndre Alle", "addressLine2": null, "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "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": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "role": "Partner", "member": { "entityName": "AKTK ApS", "caseCommonId": 14151, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "12 Store Torvegade", "addressLine2": "", "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Store Torvegade 12, 3700 Rønne", "address": "12 Store Torvegade, Rønne, 3700, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "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": null, "caseCommonId": null, "addressLine1": "2 A Elses Løkkevej", "addressLine2": null, "city": "Nexø", "stateProvince": null, "postcode": "3730", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Elses Løkkevej 2 A , Snogebæk, 3730 Nexø, Denmark", "address": "2 A Elses Løkkevej, Nexø, 3730, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "role": "Partner", "member": { "firstName": "Ole", "lastName": "BONDERUP", "caseCommonId": 14153, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "1 Broløkke", "addressLine2": null, "city": "Svaneke", "stateProvince": null, "postcode": "3740", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Broløkke 1 , Østermarie, 3740 Svaneke, Denmark", "address": "1 Broløkke, Svaneke, 3740, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "role": "Partner", "member": { "firstName": "Anders", "lastName": "KOFOED", "caseCommonId": 14154, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "94 Aaker", "addressLine2": null, "city": "Aakirkeby", "stateProvince": null, "postcode": "3720", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Søndre Landevej 94 , Aaker, 3720 Aakirkeby, Denmark", "address": "94 Aaker, Aakirkeby, 3720, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "role": "Partner", "member": { "firstName": "Tonny", "lastName": "KOFOED", "caseCommonId": 14155, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "37 Kapelvej", "addressLine2": null, "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Kapelvej 37 , Rønne, 3700 Rønne, Denmark", "address": "37 Kapelvej, Rønne, 3700, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "role": "Director", "member": { "firstName": "Dan", "lastName": "Linddal Bechmann ANDERSEN", "caseCommonId": 14150, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "38 C Søndre Alle", "addressLine2": null, "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "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": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "role": "Director", "member": { "entityName": "AKTK ApS", "caseCommonId": 14151, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "12 Store Torvegade", "addressLine2": "", "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Store Torvegade 12, 3700 Rønne", "address": "12 Store Torvegade, Rønne, 3700, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "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": null, "caseCommonId": null, "addressLine1": "2 A Elses Løkkevej", "addressLine2": null, "city": "Nexø", "stateProvince": null, "postcode": "3730", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Elses Løkkevej 2 A , Snogebæk, 3730 Nexø, Denmark", "address": "2 A Elses Løkkevej, Nexø, 3730, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": false }, { "role": "Director", "member": { "firstName": "Ole", "lastName": "BONDERUP", "caseCommonId": 14153, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "1 Broløkke", "addressLine2": null, "city": "Svaneke", "stateProvince": null, "postcode": "3740", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Broløkke 1 , Østermarie, 3740 Svaneke, Denmark", "address": "1 Broløkke, Svaneke, 3740, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": false }, { "role": "Director", "member": { "firstName": "Anders", "lastName": "KOFOED", "caseCommonId": 14154, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "94 Aaker", "addressLine2": null, "city": "Aakirkeby", "stateProvince": null, "postcode": "3720", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Søndre Landevej 94 , Aaker, 3720 Aakirkeby, Denmark", "address": "94 Aaker, Aakirkeby, 3720, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": false }, { "role": "Director", "member": { "firstName": "Tonny", "lastName": "KOFOED", "caseCommonId": 14155, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "37 Kapelvej", "addressLine2": null, "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Kapelvej 37 , Rønne, 3700 Rønne, Denmark", "address": "37 Kapelvej, Rønne, 3700, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "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": null, "caseCommonId": null, "addressLine1": "94 Aaker", "addressLine2": null, "city": "Aakirkeby", "stateProvince": null, "postcode": "3720", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Søndre Landevej 94 , Aaker, 3720 Aakirkeby, Denmark", "address": "94 Aaker, Aakirkeby, 3720, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "shares": 27, "member": { "firstName": "Tonny", "lastName": "KOFOED", "caseCommonId": 14155, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "37 Kapelvej", "addressLine2": null, "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Kapelvej 37 , Rønne, 3700 Rønne, Denmark", "address": "37 Kapelvej, Rønne, 3700, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": true }, { "shares": 0, "member": { "firstName": "Dan", "lastName": "Linddal Bechmann ANDERSEN", "caseCommonId": 14150, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "38 C Søndre Alle", "addressLine2": null, "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "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": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": false }, { "shares": 0, "member": { "entityName": "AKTK ApS", "caseCommonId": 14151, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "12 Store Torvegade", "addressLine2": "", "city": "Rønne", "stateProvince": null, "postcode": "3700", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Store Torvegade 12, 3700 Rønne", "address": "12 Store Torvegade, Rønne, 3700, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "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": null, "caseCommonId": null, "addressLine1": "2 A Elses Løkkevej", "addressLine2": null, "city": "Nexø", "stateProvince": null, "postcode": "3730", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Elses Løkkevej 2 A , Snogebæk, 3730 Nexø, Denmark", "address": "2 A Elses Løkkevej, Nexø, 3730, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": false }, { "shares": 0, "member": { "firstName": "Ole", "lastName": "BONDERUP", "caseCommonId": 14153, "jurisdictionId": 62, "codeISO31662": "DK", "address": { "caseAddressId": null, "caseCommonId": null, "addressLine1": "1 Broløkke", "addressLine2": null, "city": "Svaneke", "stateProvince": null, "postcode": "3740", "country": "Denmark", "countryCodeISO31662": null, "countryId": 62, "rawAddress": "Broløkke 1 , Østermarie, 3740 Svaneke, Denmark", "address": "1 Broløkke, Svaneke, 3740, Denmark", "userId": null, "creatorName": null, "createdDatetime": null }, "properties": {} }, "memberType": "Individual", "isKYCed": false } ] } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "403": { "description": "Access denied", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/companies/{caseCommonId}/properties/{dataType}": { "delete": { "description": "Removes company case property by data type.", "operationId": "5a4222311257bc0ca8459629", "summary": "Remove Company Case Property", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "", "required": true, "type": "string" }, { "name": "dataType", "in": "path", "description": "", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Return all case properties for particular company case.", "schema": { "$ref": "#/definitions/CasePropertiesArrayResult" }, "examples": { "application/json": "[\n {\n \"dataType\": \"Activity Type\",\n \"data\": \"Any type\"\n },\n {\n \"dataType\": \"Other Names\",\n \"data\": \"Test Limited\"\n }\n]" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid DataType", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/individuals/{caseCommonId}/properties/{dataType}": { "delete": { "description": "Removes individual case property by data type.", "operationId": "5a422a1a1257bc0ca845962a", "summary": "Remove Individual Case Property", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "", "required": true, "type": "string" }, { "name": "dataType", "in": "path", "description": "", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Return all case properties for particular individual case.", "schema": { "$ref": "#/definitions/CasePropertiesArrayResult" }, "examples": { "application/json": "[\n {\n \"dataType\": \"Birth Date\",\n \"data\": \"01/01/2000\"\n }\n]" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid DataType", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/companies/{caseCommonId}/documents/request": { "post": { "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", "summary": "Request Company Case Documents", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "documentsRequestBodyCompany", "in": "body", "schema": { "$ref": "#/definitions/DocumentsRequestBodyCompany" }, "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.\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;\n- email - optional email address to receive email with access code and link to upload portal;\n- phone - optional phone number to reveive SMS with access code to upload reqeusted documents using mobile application.\n- allowEdit - optional paramether that allow edit/add company information." } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Response contains the following data:\n- uploadUrl - link to portal to upload requested documents;\n- accessCode - access code which should be provided during uploading documents using both upload portal and mobile application;\n- emailSent - indicates if email was sent;\n- smsSent - indicates if SMS was sent.", "schema": { "$ref": "#/definitions/DocumentsRequestResult" }, "examples": { "application/json": { "uploadUrl": "https://dev.kycl.io/upload/+A00000", "accessCode": "+A00000", "emailSent": true, "smsSent": false } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/individuals/{caseCommonId}/documents/request": { "post": { "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", "summary": "Request Individual Case Documents", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "documentsRequestBodyIndividual", "in": "body", "schema": { "$ref": "#/definitions/DocumentsRequestBodyIndividual" }, "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.\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;\n- email - optional email address to receive email with access code and link to upload portal;\n- phone - optional phone number to reveive SMS with access code to upload reqeusted documents using mobile application.\n- allowEdit - optional paramether that allow to edit/add individual information." } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Response contains the following data:\n- uploadUrl - link to portal to upload requested documents;\n- accessCode - access code which should be provided during uploading documents using both upload portal and mobile application;\n- emailSent - indicates if email was sent;\n- smsSent - indicates if SMS was sent.", "schema": { "$ref": "#/definitions/DocumentsRequestResult" }, "examples": { "application/json": { "uploadUrl": "https://dev.kycl.io/upload/+A00000", "accessCode": "+A00000", "emailSent": false, "smsSent": false } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/companies/{caseCommonId}/documents/upload": { "post": { "description": "Uploads the document to company case.", "operationId": "5a58882f1257bc0aa819a425", "summary": "Upload Document To Company Case", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "body", "in": "body", "schema": {}, "description": "Request body includes file you wanted to upload and form-data to describe uploaded document.\n\nDocument data:
\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;\n\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;\n\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." } ], "consumes": [ "multipart/form-data" ], "responses": { "200": { "description": "Uploaded document result", "schema": { "$ref": "#/definitions/UploadDocumentResult" }, "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid API Key", "timeStamp": "7/28/2017 2:15:51 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/individuals/{caseCommonId}/documents/upload": { "post": { "description": "Uploads the document to Individual case.", "operationId": "5a589e401257bc0aa819a426", "summary": "Upload Document To Individual Case", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "body", "in": "body", "schema": {}, "description": "Request body includes file you wanted to upload and form-data to describe uploaded document.\n\nDocument data:
\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;\n\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;\n\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." } ], "consumes": [ "multipart/form-data" ], "responses": { "200": { "description": "Uploaded document result", "schema": { "$ref": "#/definitions/UploadDocumentResult" }, "examples": { "application/json": { "caseCommonId": 16627, "caseDocumentId": 93349, "category": "photoid", "name": "Photo ID", "link": "https://kyc.azure-api.net/v2/documents/93349" } } }, "400": { "description": "Invalid request parameters or photo id pre-validation failed", "examples": { "application/json": { "statusCode": 400, "message": "Api Errors", "apiErrors": [ { "description": "Face not recognized on document", "timeStamp": "4/25/2019 12:19:30 PM" }, { "description": "Identity document not recognized", "timeStamp": "4/25/2019 12:19:30 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/individuals/import": { "post": { "description": "Import a new individual case", "operationId": "5af35097049b5e1e7cb9059c", "summary": "Import Individual Case", "parameters": [ { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "createIndividualCaseBody", "in": "body", "schema": { "$ref": "#/definitions/CreateIndividualCaseBody" }, "description": "Individual data.\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n \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
" } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Return created individual case details:\n\ncommon - case common object:\n- caseCommonId - individual case identifier in Know Your Customer web application;\n- caseCustomerId - identifier of the individual case for related customer;\n- type - case common type code.\n- typeString - case common type name. Text representation of the type;\n- complete - indicates percentage of case automatic verification process completion;\n- edit - deprecated field;\n- status - current status of the individual case, representing the case has been manually \nclosed by a user or not. Can be \"Open\" or \"Closed\";\n- statusId - representing current state of the case. Available status identifiers see in the table below.\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\n- isVisible - indicates if the individual case is visible in Know Your Customer web \n- isAMLCase - indicates should we check on anti money laundering only or not;\n- countryRisk - anti money laundering country risk score;\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\n\nindividual - case individual object:\n- caseIndividualId - individual identifier in Know Your Customer web application;\n- firstName - individual's first name;\n- lastName - individual's last name;\n- countryCodeISO31662 - country code of individual case defined in ISO 3166-2 standard;\n- nationalityCodeISO31662 - country code of the nationality defined in ISO 3166-2 standard;\n- properties - object which can contain different set of data like Date of Birth, Occupdation, etc;\n\ncaseAddress - case address object:\n- caseAddressId - case address identifier in Know Your Customer web application;\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\n- rawAddress - address received from registry;\n- address - normalized address;\n\nAvailable case common status identifiers:\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

statusId

\n
\n

Meaning

\n
\n

Applies to what Cases

\n
\n

Description

\n
\n

0

\n
\n

Initializing

\n
\n

Companies and Individuals

\n
\n

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

\n
\n

1

\n
\n

Data Collection

\n
\n

Companies and Individuals

\n
\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

\n
\n

2

\n
\n

Data Verification

\n
\n

\n

Companies and Individuals

\n

\n
\n

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

\n
\n

3

\n
\n

Ready

\n
\n

Companies and Individuals

\n\n
\n

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

\n
\n

4-49

\n
\n

Reserved

\n
\n

Companies and Individuals

\n
\n

-

\n
\n

50

\n
\n

RetrievingBasicData

\n
\n

Companies

\n
\n

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

\n
\n

51

\n
\n

IdentifyingControllingEntities

\n
\n

Companies

\n
\n

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

\n
\n

52

\n
\n

RetrievingExtendedData

\n
\n

Companies

\n
\n

Retrieving extended company data, if available

\n
\n

53

\n
\n

DownloadingCompanyDocuments

\n
\n

Companies

\n
\n

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

\n
\n

54

\n
\n

IdentifyingBeneficialOwners

\n
\n

Companies

\n
\n

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

\n
\n

55

\n
\n

PreparingChildren

\n
\n

Companies

\n
\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)

\n
\n

56

\n
\n

CheckingListedEntities

\n
\n

Companies

\n
\n

Checking for market listed entities

\n
\n

57-99

\n
\n

Reserved

\n
\n

Companies

\n
\n\n

 

\n
\n

100

\n
\n

PerformingAmlChecks

\n
\n

Individuals

\n
\n

Performing Individual AML Checks

\n
\n

101

\n
\n

PerformingAddressChecks

\n
\n

Individuals

\n
\n

Performing Individual Address Checks in available Jurisdictions

\n
\n

102

\n
\n

PerformingCourtChecks

\n
\n

Individuals

\n
\n

Performing Individual Courts Data Checks in available Jurisdictions

\n
\n

103-150

\n
\n

Reserved

\n
\n

Individuals

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
", "schema": { "$ref": "#/definitions/IndividualCaseDetailResult" }, "examples": { "application/json": { "caseDetail": { "details": { "individual": { "caseIndividualId": 8905, "firstName": "John", "lastName": "Doe", "countryCodeISO31662": "PT", "country": "Portugal", "email": null, "phone": null, "nationalityCountryCodeISO31662": "GB", "nationalityCountry": "United kingdom", "caseCommonId": 14050, "creatorId": "db557fed-99b5-4c8a-b3c9-5d2d42d2bc13", "properties": { "Birth Date": "01/01/1990" }, "createdDatetime": "2017-11-24T11:44:17.22" }, "common": { "caseCommonId": 14069, "caseCustomerId": 1165, "customerId": 224, "customerName": "AndreiCo", "type": 2, "typeString": "Individual", "scoring": 0, "complete": 0, "edit": true, "status": "Open", "statusChangedDatetime": null, "statusChangedBy": null, "statusId": null, "caseDecision": null, "isVisible": true, "creatorId": "db557fed-99b5-4c8a-b3c9-5d2d42d2bc13", "creatorUserName": "avgybarev@gmail.com", "createdDatetime": "2017-11-24T13:41:58.03", "updatedBySystem": null, "isAMLCase": null, "updatedByUser": null, "customerDepartmentId": 1249, "customerDepartmentName": "Management", "countryRisk": 4.77, "assignedUserId": null, "assignedUserName": null, "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": null, "postcode": null, "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.893" } } } } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Internal Error", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/individuals/{caseCommonId}/link/{childCaseCommonId}": { "post": { "description": "Links individual child case to parent individual case.", "operationId": "5abde14d049b5e19fce1a103", "summary": "Link Individual Case To Individual", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "childCaseCommonId", "in": "path", "description": "Child Case Common identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "linkCaseToIndividualBody", "in": "body", "schema": { "$ref": "#/definitions/LinkCaseToIndividualBody" }, "description": "Object describes what type of relation should be created between child case and parent individual:\n\nrelationType - relation type. Possible values described in the table below.\n\nPossible relationType values:\n\n \n \n \n \n \n \n \n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\n \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
" } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Return new created relationship description.", "schema": { "$ref": "#/definitions/LinkCaseToIndividualResult" }, "examples": { "application/json": { "success": true, "relationshipDescriptions": [ "Sibling" ] } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "403": { "description": "Access denied", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/companies/{caseCommonId}/identity": { "put": { "description": "Update existing company identity information.", "operationId": "5af2ed13049b5e10c0c830b8", "summary": "Update Company", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "createCaseBody", "in": "body", "schema": { "$ref": "#/definitions/CreateCaseBody" }, "description": "Company data.\n\n \n\t\t\n\t\t\t\n \n \n\t\t\n\t\n\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\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
" } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Return created company case details:\n\ncommon - case common object:\n- caseCommonId - newly created company case identifier in Know Your Customer web application;\n- caseCustomerId - identifier of the company case for related customer;\n- type - case common type code.\n- typeString - case common type name. Text representation of the type. Can be \"Company\" or \"Individual\";\n- complete - indicates percentage of case automatic verification process completion;\n-edit - deprecated field;\n- status - current status of the company case, representing the case has been manually \nclosed by a user or not. Can be \"Open\" or \"Closed\";\n- statusId - represents current state of the case. Available status identifiers see in the table below.\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\n- isVisible - indicates if the company case is visible in Know Your Customer web \n- isAMLCase - indicates should we check on anti money laundering only or not;\n- countryRisk - anti money laundering country risk score;\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\n- caseProcessingType - case processing type, \"\" for regular case processing, \"Lite\" for KYC Lite cases;\n\ncompany - case company object:\n- caseCompanyId - company identifier in Know Your Customer web application;\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\n- type - type of business entity;\n- properties - object which can contain different set of data depending from jurisdiction and registry. Will be empty for this operation.\n\ncaseAddress - case address object:\n- caseAddressId - case address identifier in Know Your Customer web application;\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\n- rawAddress - address received from registry;\n- address - normalized address;\n\nAvailable case common status identifiers:\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

statusId

\n
\n

Meaning

\n
\n

Applies to what Cases

\n
\n

Description

\n
\n

0

\n
\n

Initializing

\n
\n

Companies and Individuals

\n
\n

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

\n
\n

1

\n
\n

Data Collection

\n
\n

Companies and Individuals

\n
\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

\n
\n

2

\n
\n

Data Verification

\n
\n

\n

Companies and Individuals

\n

\n
\n

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

\n
\n

3

\n
\n

Ready

\n
\n

Companies and Individuals

\n\n
\n

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

\n
\n

4-49

\n
\n

Reserved

\n
\n

Companies and Individuals

\n
\n

-

\n
\n

50

\n
\n

RetrievingBasicData

\n
\n

Companies

\n
\n

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

\n
\n

51

\n
\n

IdentifyingControllingEntities

\n
\n

Companies

\n
\n

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

\n
\n

52

\n
\n

RetrievingExtendedData

\n
\n

Companies

\n
\n

Retrieving extended company data, if available

\n
\n

53

\n
\n

DownloadingCompanyDocuments

\n
\n

Companies

\n
\n

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

\n
\n

54

\n
\n

IdentifyingBeneficialOwners

\n
\n

Companies

\n
\n

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

\n
\n

55

\n
\n

PreparingChildren

\n
\n

Companies

\n
\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)

\n
\n

56

\n
\n

CheckingListedEntities

\n
\n

Companies

\n
\n

Checking for market listed entities

\n
\n

57-99

\n
\n

Reserved

\n
\n

Companies

\n
\n\n

 

\n
\n

100

\n
\n

PerformingAmlChecks

\n
\n

Individuals

\n
\n

Performing Individual AML Checks

\n
\n

101

\n
\n

PerformingAddressChecks

\n
\n

Individuals

\n
\n

Performing Individual Address Checks in available Jurisdictions

\n
\n

102

\n
\n

PerformingCourtChecks

\n
\n

Individuals

\n
\n

Performing Individual Courts Data Checks in available Jurisdictions

\n
\n

103-150

\n
\n

Reserved

\n
\n

Individuals

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
", "schema": { "$ref": "#/definitions/CaseDetailResult" }, "examples": { "application/json": { "caseDetail": { "details": { "common": { "caseCommonId": 10001, "caseCustomerId": 889, "customerId": 224, "customerName": "YourCustomer", "type": 1, "typeString": "Company", "scoring": 0, "complete": 0, "edit": true, "status": "Open", "statusChangedDatetime": null, "statusChangedBy": null, "statusId": 0, "caseDecision": null, "isVisible": true, "creatorId": "db557fed-99b5-4c8a-b3c9-5d2d42d2bc13", "creatorUserName": "example@example.com", "createdDatetime": "2017-10-20T21:30:53.863", "updatedBySystem": null, "isAMLCase": false, "updatedByUser": null, "customerDepartmentId": 1249, "customerDepartmentName": "Management", "countryRisk": 4.77, "assignedUserId": null, "assignedUserName": null, "link": "https://app.knowyourcustomer.com/casecompany/10001/detail", "caseProcessingType": "", "isComplexStructure": true, "caseDrillDownLevel": 2 }, "company": { "id": 3777, "caseCompanyId": 3777, "caseCommonId": 10001, "countryCodeISO31662": "GB", "entityName": "TEST AIR SERVICES LTD", "type": null, "description": "Case Generated from API2", "userId": "db557fed-99b5-4c8a-b3c9-5d2d42d2bc13", "creatorId": "db557fed-99b5-4c8a-b3c9-5d2d42d2bc13", "createdDatetime": "2017-10-20T21:30:54.09", "properties": {} }, "caseAddress": { "caseAddressId": 9950, "caseCommonId": 10001, "addressLine1": null, "addressLine2": null, "city": null, "stateProvince": null, "postcode": null, "country": null, "countryCodeISO31662": null, "countryId": null, "rawAddress": null, "address": null, "userId": null, "creatorName": null, "createdDatetime": "2017-10-20T21:30:54.093" } } } } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Internal Error", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/individuals/{caseCommonId}/identity": { "put": { "description": "Update an existing individual case", "operationId": "5af2efbb049b5e10c0c830b9", "summary": "Update Individual Case", "parameters": [ { "name": "caseCommonId", "in": "path", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "createIndividualCaseBody", "in": "body", "schema": { "$ref": "#/definitions/CreateIndividualCaseBody" }, "description": "Individual data.\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\t\n \n \n \n \n\t\n \n \n \n \n\t\n \n \n \n \n\t\n \n \n \n \n \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
deviceLnglongitude of user's device when verifying addressNo
deviceLatlatitude of user's device when verifying addressNo
" } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Return created individual case details:\n\ncommon - case common object:\n- caseCommonId - individual case identifier in Know Your Customer web application;\n- caseCustomerId - identifier of the individual case for related customer;\n- type - case common type code.\n- typeString - case common type name. Text representation of the type;\n- complete - indicates percentage of case automatic verification process completion;\n- edit - deprecated field;\n- status - current status of the individual case, representing the case has been manually \nclosed by a user or not. Can be \"Open\" or \"Closed\";\n- statusId - representing current state of the case. Available status identifiers see in the table below.\n- caseDecision - final decision made for a closed case, either \"Accepted\" or \"Denied\". If case is still open, null is returned.\n- isVisible - indicates if the individual case is visible in Know Your Customer web \n- isAMLCase - indicates should we check on anti money laundering only or not;\n- countryRisk - anti money laundering country risk score;\n- customerDepartmentId - identifier of the cusotmer's department in Know Your Customer web application;\n\nindividual - case individual object:\n- caseIndividualId - individual identifier in Know Your Customer web application;\n- firstName - individual's first name;\n- lastName - individual's last name;\n- countryCodeISO31662 - country code of individual case defined in ISO 3166-2 standard;\n- nationalityCodeISO31662 - country code of the nationality defined in ISO 3166-2 standard;\n- properties - object which can contain different set of data like Date of Birth, Occupdation, etc;\n\ncaseAddress - case address object:\n- caseAddressId - case address identifier in Know Your Customer web application;\n- countryCodeISO31662 - country code defined in ISO 3166-2 standard;\n- rawAddress - address received from registry;\n- address - normalized address;\n- deviceLng - longitude of user's device when verifying address;\n- deviceLat - latitude of user's device when verifying address;\n- geolocationVerified - verification result user location matches provided address. Possible values: \"Verification successful\", \"Verification failed\", \"Not Verified\" (address or user location are not specified), \"Not Available\" (geolocation feature is not included in the plan);\n\nAvailable case common status identifiers:\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

statusId

\n
\n

Meaning

\n
\n

Applies to what Cases

\n
\n

Description

\n
\n

0

\n
\n

Initializing

\n
\n

Companies and Individuals

\n
\n

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

\n
\n

1

\n
\n

Data Collection

\n
\n

Companies and Individuals

\n
\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

\n
\n

2

\n
\n

Data Verification

\n
\n

\n

Companies and Individuals

\n

\n
\n

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

\n
\n

3

\n
\n

Ready

\n
\n

Companies and Individuals

\n\n
\n

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

\n
\n

4-49

\n
\n

Reserved

\n
\n

Companies and Individuals

\n
\n

-

\n
\n

50

\n
\n

RetrievingBasicData

\n
\n

Companies

\n
\n

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

\n
\n

51

\n
\n

IdentifyingControllingEntities

\n
\n

Companies

\n
\n

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

\n
\n

52

\n
\n

RetrievingExtendedData

\n
\n

Companies

\n
\n

Retrieving extended company data, if available

\n
\n

53

\n
\n

DownloadingCompanyDocuments

\n
\n

Companies

\n
\n

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

\n
\n

54

\n
\n

IdentifyingBeneficialOwners

\n
\n

Companies

\n
\n

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

\n
\n

55

\n
\n

PreparingChildren

\n
\n

Companies

\n
\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)

\n
\n

56

\n
\n

CheckingListedEntities

\n
\n

Companies

\n
\n

Checking for market listed entities

\n
\n

57-99

\n
\n

Reserved

\n
\n

Companies

\n
\n\n

 

\n
\n

100

\n
\n

PerformingAmlChecks

\n
\n

Individuals

\n
\n

Performing Individual AML Checks

\n
\n

101

\n
\n

PerformingAddressChecks

\n
\n

Individuals

\n
\n

Performing Individual Address Checks in available Jurisdictions

\n
\n

102

\n
\n

PerformingCourtChecks

\n
\n

Individuals

\n
\n

Performing Individual Courts Data Checks in available Jurisdictions

\n
\n

103-150

\n
\n

Reserved

\n
\n

Individuals

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
\n\n

 

\n
", "schema": { "$ref": "#/definitions/IndividualCaseDetailResult" }, "examples": { "application/json": { "caseDetail": { "details": { "individual": { "caseIndividualId": 8905, "firstName": "John", "lastName": "Doe", "countryCodeISO31662": "PT", "country": "Portugal", "email": null, "phone": null, "nationalityCountryCodeISO31662": "GB", "nationalityCountry": "United kingdom", "caseCommonId": 14050, "creatorId": "db557fed-99b5-4c8a-b3c9-5d2d42d2bc13", "properties": { "Birth Date": "01/01/1990" }, "createdDatetime": "2017-11-24T11:44:17.22" }, "common": { "caseCommonId": 14069, "caseCustomerId": 1165, "customerId": 224, "customerName": "AndreiCo", "type": 2, "typeString": "Individual", "scoring": 0, "complete": 0, "edit": true, "status": "Open", "statusChangedDatetime": null, "statusChangedBy": null, "statusId": null, "caseDecision": null, "isVisible": true, "creatorId": "db557fed-99b5-4c8a-b3c9-5d2d42d2bc13", "creatorUserName": "avgybarev@gmail.com", "createdDatetime": "2017-11-24T13:41:58.03", "updatedBySystem": null, "isAMLCase": null, "updatedByUser": null, "customerDepartmentId": 1249, "customerDepartmentName": "Management", "countryRisk": 4.77, "assignedUserId": null, "assignedUserName": null, "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": null, "postcode": null, "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.893", "deviceLng": -10.1248091, "deviceLat": 41.4994791, "geolocationVerified": "Verification successful" } } } } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Internal Error", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/companyTypes": { "get": { "description": "Get available company types", "operationId": "5b84e90ff664c597254ec0cd", "summary": "Company Types", "parameters": [ { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns list of the available jurisdictions", "schema": { "$ref": "#/definitions/" }, "examples": { "application/json": "[\n \"Branch\",\n \"Company limited by guarantee\",\n \"Consortium\",\n \"Cooperative\",\n \"Corporation\",\n \"External company\",\n \"Foreign branch\",\n \"Foreign Companie\",\n \"Foreign subsidiary company\",\n \"Foundation\",\n \"General partnership\",\n \"Government owned with variable capital and variable shareholders\",\n \"Incorporated\",\n \"Investment company\",\n \"Limited Liability Company\",\n \"Limited liability cooperative\",\n \"Limited liability foundation\",\n \"Limited Liability Limited Partnership\",\n \"Limited Liability Partnerships\",\n \"Limited Partnership\",\n \"Limited partnership - ILP\",\n \"Limited partnership - LLP\",\n \"Limited partnership - LP\",\n \"Madras\",\n \"Management Corporation\",\n \"Mosque\",\n \"National Association\",\n \"National Trust and Savings Association\",\n \"News Bureau\",\n \"Other/Non-corporate\",\n \"Other/Partnership\",\n \"Private company\",\n \"Private company limited by guarantee without share capital\",\n \"Private company limited by shares\",\n \"Private foundation\",\n \"Professional Limited Liability Company\",\n \"Property management company\",\n \"Public Accounting Firm\",\n \"Public company\",\n \"Public Company Limited by Guarantee\",\n \"Public company limited by shares\",\n \"Register of Commerce and Companies\",\n \"Sole proprietorship\",\n \"State-owned enterprise\",\n \"Trade Union\",\n \"Trust\",\n \"Undetermined\",\n \"Unlimited company\"\n]" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid API Key", "timeStamp": "7/28/2017 2:15:51 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/companies/{caseCommonId}/amlchecks": { "get": { "description": "Gets the AML Check results for the selected company", "operationId": "5bed8b6c24ff61cef6216e33", "summary": "Company AML Checks", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns all AML Check entries found in the case and not excluded\n\ncompany - case common details:\n- caseCommonId - company case identifier in Know Your Customer web application;\n- lastName - the name of the company;\n\nworldChecks - all AML entries found in WorldCheck. Each entity has the following properties:\n- category - the type of company (e.g. CORPORATE, BANK, etc.);\n- firstName - always empty;\n- lastName - the name of the company found in Worldcheck;\n- dateOfBirth - always empty;\n- placeOfBirth - always empty;\n- citizenship - country in which the company operates;\n- aliases - other possible names for the company;\n- entered - date in which the entry was added in WorldCheck;\n- externalMediaFound - links to additional information about the entry;\n- furtherInformation - additional information about the entry;\n- locations - additional details about the location in which the entry was added;\n\nlexisNexisChecks - all AML entries found in LexisNexis. Each entity has the following properties:\n- category - the type of AML entry (e.g. PEP, ADVERSEMEDIA, etc.);\n- firstName - always empty;\n- lastName - the name of the company found in Worldcheck;\n- dateOfBirth - always empty;\n- placeOfBirth - always empty;\n- occupation - always empty;\n- entered - date in which the entry was added in WorldCheck;\n- associations - additional information about the entry;\n", "schema": { "$ref": "#/definitions/CompanyAmlCheckResult" }, "examples": { "application/json": { "company": { "caseCommonId": 100921, "lastName": "TESTING COMPANY" }, "worldChecks": [ { "category": "CORPORATE", "firstName": "", "lastName": "TESTING COMPANY", "dateOfBirth": "", "placeOfBirth": "", "citizenship": "INDONESIA", "aliases": "ALIAS COMPANY", "entered": "2002/02/08", "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": null, "placeOfBirth": null, "occupation": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc sapien quam, tempor nec ipsum a.", "entered": "2016/08/04", "associations": "Wife (PEP:Govt Branch Member): Testing, Name, 1328143,Relative (PEP:Govt Branch Member): Name, Test Other, 124531" } ] } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/individuals/{caseCommonId}/amlchecks": { "get": { "description": "Gets AML Check results for the selected case", "operationId": "5bed8a736951ef71f349d631", "summary": "Individual AML Checks", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns all AML Check entries found in the case and not excluded\n\nindividual - case common details:\n- caseCommonId - company case identifier in Know Your Customer web application;\n- lastName - the last name of the person;\n- firstName - the first name of the person;\n\nworldChecks - all AML entries found in WorldCheck. Each entity has the following properties:\n- category - the type of AML entry (e.g. INDIVIDUAL, TERRORISM, LEGAL, etc.);\n- firstName - the first name of the person;\n- lastName - the last name of the person;\n- dateOfBirth - the date in which person was born;\n- placeOfBirth - the location in which person was born;\n- citizenship - the citizenship of hte person;\n- aliases - other names found for the person;\n- entered - date in which the entry was added in WorldCheck;\n- externalMediaFound - links to additional information about the entry;\n- furtherInformation - additional information about the entry;\n- locations - additional details about the location in which the entry was added;\n\nlexisNexisChecks - all AML entries found in LexisNexis. Each entity has the following properties:\n- category - the type of AML entry (e.g. INDIVIDUAL, TERRORISM, LEGAL, etc.);\n- firstName the first name of the person;\n- lastName - the last name of the person;\n- dateOfBirth - the date in which person was born;\n- placeOfBirth - the location in which person was born;\n- occupation - the occupation of the person;\n- entered - date in which the entry was added in WorldCheck;\n- associations - additional information about the entry;\n", "schema": { "$ref": "#/definitions/IndividualAmlCheckResult" }, "examples": { "application/json": { "individual": { "caseCommonId": 14456, "lastName": "Testing", "firstName": "Individual" }, "worldChecks": [ { "category": "LEGAL", "firstName": "Testing I", "lastName": "Indivdual", "dateOfBirth": "", "placeOfBirth": "", "citizenship": "USA", "aliases": "", "entered": "2010/08/24", "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", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/casesteps/{caseCommonId}/details/{stepId}": { "get": { "description": "Gets full details for an existing case step.", "operationId": "5c798f7d723e87f88505448d", "summary": "Case Step Details", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "stepId", "in": "path", "description": "Case Step identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns basic step properties as in Get Steps action plus additional Details field that is different for different steps.\n\n- name - the name of the step;\n- caseStepId - the step id;\n- isDeletable - indicates if the step can be deleted;\n- isProcessed - indicates if the step is processed;\n- isExcluded - indicates if the step is excluded (false for non Aml match cases);\n- isCollapsed - indicates if the step is collapsed;\n- isLoading - indicates if the step is loading;\n- hasNotes - indicates if the step has notes;\n- createdDatetime - step creation time ;\n- updateDatetime - step updated time;\n- type - step type;\n- status - step status (PASSED, FAILED, NOTREVIEWED);\n\nDetails\n\nDetails for Proof of Identity step\n- FaceVerification\n- IsVerified - boolean result if verification finished successful;\n- Confidence - confidence score of comparison (1-100);\n- Message - reason of verification failure ;\n- CreatedDatetime - datetime of face verification;\n- Documents - a list of:\n - Category - category of the document;\n - DocumentAvailable - indicate if document(s) is available(i .e uploaded or not);\n - VerificationStatus - \"Not Verified\", \"Verification successful\", \"Verification failed\";\n - CaseDocumentID - unique identifier for the document ;\n - Name - name of the document;\n - Link - link to document location, if document is available ;\n - VerificationDetails - Section with document verification details\n - Success - boolean result if verification finished successfully\n - TriggeredRule - pattern which applied to make decision based on verification result\n - Result - validation result. Possible values 'Valid', 'Warning', 'Fail'\n - Message - validation status, e.g. DocumentPassedAuthentication\n - Sensitivity - document verification sensitivity\n - Decision - possible values 'Verified', 'Deviated', 'Expired', 'RequiresFurtherReview', 'PotentialForgery'\n - Properties - rule properties\n - FailUpload - document upload status\n - ImageQuality - image quality description\n - Percentage - measure of image quality. Can take values from 0 to 100\n - Value - image quality group. Possible values: VeryLow, Low, Average, High, Perfect\n - ForgeryTests - a list of forgery tests:\n - Group - group of the test. Can take values 'Data Integrity', 'Digital', 'Structure', 'Visible'\n - Type - type of the test\n - Result -test result. Can take values Authenticated, Failed, Forged, Unconclusive, UnableToComplete, NotRelevant\n - IdentityReport - identity information\n - FirstName - first name\n - LastName - last name\n - BirthDate - birth date\n - SourceDocument - document type, e.g. 'Passport'\n - BirthPlace - birth place\n - ExpiryDate - document expiry date\n - DocumentNumber - document number\n - DocumentCountryOfOrigin - country of document's origin\n - Address - address\n - Message - status message of verification report\n\nDetails for Aml match step of Individual case\n- category - the type of AML entry (e.g. INDIVIDUAL, TERRORISM, LEGAL, etc.);\n- firstName - the first name of the person;\n- lastName - the last name of the person;\n- dateOfBirth - the date in which person was born;\n- placeOfBirth - the location in which person was born;\n- citizenship - the citizenship of the person;\n- aliases - other names found for the person;\n- entered - date in which the entry was added in WorldCheck;\n- externalMediaFound - links to additional information about the entry;\n- furtherInformation - additional information about the entry;\n- locations - additional details about the location in which the entry was added;\n- biography - the biography of the person;\n- identification - the identification of the person;\n- reports - reports for the person;\n\nDetails for Search results step\n- ResultsCount - the number of search results;\n- Documents - a list of:\n- Title - search result title;\n- Url - search result url;\n\nDetails for step with documents e.g. Proof of address\n- Documents - a list of:\n- Category - category of the document;\n- DocumentAvailable - indicate if document(s) is available(i .e uploaded or not);\n- VerificationStatus - \"Not Verified\", \"Verification successful\", \"Verification failed\";\n- CaseDocumentID - unique identifier for the document ;\n- Name - name of the document;\n- Link - link to document location, if document is available ;", "schema": { "$ref": "#/definitions/" }, "examples": { "application/json": { "Name": "Anti-money laundering", "CaseStepId": 1496943, "IsDeletable": true, "IsProcessed": true, "IsExcluded": true, "IsCollapsed": false, "IsLoading": false, "HasNotes": false, "CreatedDatetime": "2019-02-14T14:51:28.333", "UpdateDatetime": "2019-02-20T09:53:59.797", "Type": "TEXT", "Status": "PASSED", "Details": { "Category": "DIPLOMAT", "FirstName": "Mayuma Teresa", "LastName": "AFONSO", "DateOfBirth": "", "PlaceOfBirth": "", "Citizenship": "ANGOLA", "Aliases": "ANDRE,Mayuma Teresa;ANDR?,Mayuma Teresa", "Entered": "2008/02/08", "ExternalMediaFound": "http://w01.international.gc.ca/Protocol/pdf/DrsBook_2008_01_eng.pdf http://www.dges.mctes.pt/NR/rdonlyres/57AE85E4-C93E-405D-B94F-79F26576A8EA/6473/LivroCorpoDiplomaticoAcreditado.pdf http://www.portugal.gov.pt/media/1498918/livro-corpo-diplomatico-2014-agosto.pdf", "FurtherInformation": "[BIOGRAPHY] Financial Attach? to Portugal (reported Feb 2012 - ). Attach? to Canada (reported Jan 2008). [IDENTIFICATION] To be determined. [REPORTS] Aug 2015 - no further information reported.", "Locations": "~ Faro, Faro ~ PORTUGAL;~ Ottawa, Ontario ~ CANADA;~,~ ANGOLA", "Biography": "Financial Attach? to Portugal (reported Feb 2012 - ). Attach? to Canada (reported Jan 2008).", "Identification": "To be determined.", "Reports": "Aug 2015 - no further information reported." } } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/casesteps/{caseCommonId}": { "get": { "description": "Gets list of visible steps for a case.", "operationId": "5c798d3befd616c1e775825a", "summary": "Case Steps", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns a list of all visible steps for a case in the displayed order grouped by Step Group.\n\nEach step contains:\n- name - the name of the step;\n- caseStepId - the step id;\n- isDeletable - indicates if the step can be deleted;\n- isProcessed - indicates if the step is processed;\n- isExcluded - indicates if the step is excluded (false for non Aml match cases);\n- isCollapsed - indicates if the step is collapsed;\n- isLoading - indicates if the step is loading;\n- hasNotes - indicates if the step has notes;\n- createdDatetime - step creation time ;\n- updateDatetime - step updated time;\n- type - step type;\n- status - step status (PASSED, FAILED, NOTREVIEWED);", "schema": { "$ref": "#/definitions/" }, "examples": { "application/json": "[\n {\n \"group\": \"Identity\",\n \"steps\": [\n {\n \"name\": \"Proof of Identity\",\n \"caseStepId\": 1496924,\n \"isDeletable\": true,\n \"isProcessed\": true,\n \"isExcluded\": false,\n \"isCollapsed\": false,\n \"isLoading\": false,\n \"hasNotes\": false,\n \"createdDatetime\": \"2019-02-14T14:48:52.543\",\n \"updateDatetime\": \"2019-02-26T22:24:39.833\",\n \"type\": \"TEXT\",\n \"status\": \"PASSED\"\n },\n {\n \"name\": \"Government Photo ID\",\n \"caseStepId\": 1496925,\n \"isDeletable\": true,\n \"isProcessed\": true,\n \"isExcluded\": false,\n \"isCollapsed\": false,\n \"isLoading\": false,\n \"hasNotes\": false,\n \"createdDatetime\": \"2019-02-14T14:48:52.543\",\n \"updateDatetime\": \"2019-02-18T19:15:02.897\",\n \"type\": \"TEXT\",\n \"status\": \"PASSED\"\n },\n {\n \"name\": \"Proof of address\",\n \"caseStepId\": 1496926,\n \"isDeletable\": true,\n \"isProcessed\": true,\n \"isExcluded\": false,\n \"isCollapsed\": true,\n \"isLoading\": false,\n \"hasNotes\": false,\n \"createdDatetime\": \"2019-02-14T14:48:52.543\",\n \"updateDatetime\": \"2019-02-18T18:59:47.02\",\n \"type\": \"TEXT\",\n \"status\": \"PASSED\"\n },\n {\n \"name\": \"Your Loan Documents\",\n \"caseStepId\": 1504858,\n \"isDeletable\": false,\n \"isProcessed\": true,\n \"isExcluded\": false,\n \"isCollapsed\": true,\n \"isLoading\": false,\n \"hasNotes\": false,\n \"createdDatetime\": \"2019-02-21T10:14:34.707\",\n \"updateDatetime\": null,\n \"type\": \"DOCUMENT\",\n \"status\": \"PASSED\"\n },\n {\n \"name\": \"Anti-money laundering\",\n \"caseStepId\": 1496942,\n \"isDeletable\": true,\n \"isProcessed\": true,\n \"isExcluded\": false,\n \"isCollapsed\": false,\n \"isLoading\": false,\n \"hasNotes\": false,\n \"createdDatetime\": \"2019-02-14T14:51:27.74\",\n \"updateDatetime\": \"2019-02-22T10:09:43.37\",\n \"type\": \"TEXT\",\n \"status\": \"PASSED\"\n },\n {\n \"name\": \"Anti-money laundering\",\n \"caseStepId\": 1496943,\n \"isDeletable\": true,\n \"isProcessed\": true,\n \"isExcluded\": true,\n \"isCollapsed\": false,\n \"isLoading\": false,\n \"hasNotes\": false,\n \"createdDatetime\": \"2019-02-14T14:51:28.333\",\n \"updateDatetime\": \"2019-02-20T09:53:59.797\",\n \"type\": \"TEXT\",\n \"status\": \"PASSED\"\n }, \n {\n \"name\": \"Search Results\",\n \"caseStepId\": 1496964,\n \"isDeletable\": true,\n \"isProcessed\": true,\n \"isExcluded\": false,\n \"isCollapsed\": true,\n \"isLoading\": false,\n \"hasNotes\": false,\n \"createdDatetime\": \"2019-02-14T14:52:10.473\",\n \"updateDatetime\": null,\n \"type\": \"TEXT\",\n \"status\": \"PASSED\"\n }\n ]\n }\n]" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/companies/{caseCommonId}/status": { "patch": { "description": "Close or reopen an existing company case", "operationId": "5ca71c30d0e164bfcd4a6118", "summary": "Close/Reopen Company Case", "parameters": [ { "name": "caseCommonId", "in": "path", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "companiesCaseCommonIdStatusPatchRequest", "in": "body", "schema": { "$ref": "#/definitions/CompaniesCaseCommonIdStatusPatchRequest" }, "description": "\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
NameDescriptionMandatory
status\"Open\" or \"Closed\"Yes
\n\n

Only Open and 100% Completed cases can be closed\".

\n

Only Closed cases can be reopened.

" } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Returns same result as Individual Details action." }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Internal Error", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/individuals/{caseCommonId}/status": { "patch": { "description": "Close or reopen an existing individual case", "operationId": "5c7973fa922d5899d50b9406", "summary": "Close/Reopen Individual Case", "parameters": [ { "name": "caseCommonId", "in": "path", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "individualsCaseCommonIdStatusPatchRequest", "in": "body", "schema": { "$ref": "#/definitions/IndividualsCaseCommonIdStatusPatchRequest" }, "description": "\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
NameDescriptionMandatory
status\"Open\" or \"Closed\"Yes
\n\n

Only Open and 100% Completed cases can be closed\".

\n

Only Closed cases can be reopened.

" } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Returns same result as Individual Details action." }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Internal Error", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/casecomments/": { "post": { "description": "Creates new case comment and return bool", "operationId": "create-case-comment", "summary": "Create Case Comment", "parameters": [ { "name": "ApiKey", "in": "header", "type": "string" }, { "name": "body-2", "in": "body", "schema": { "$ref": "#/definitions/Body-2" }, "description": "Body should contain model of case comment that you want to create." } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Return true\\false" }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/casecomments/{caseCommentId}": { "delete": { "description": "Removes case comment by case comment id.", "operationId": "delete-case-comment", "summary": "Delete Case Comment", "parameters": [ { "name": "caseCommentId", "in": "path", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "type": "string" } ], "responses": { "200": { "description": "Returns true\\false" }, "400": { "description": "", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid DataType", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "", "examples": { "application/json": { "statusCode": 401, "message": "Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API." } } }, "403": { "description": "", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/casesteps/{caseCommonId}/exclude/{stepId}": { "patch": { "description": "Exclude or include back an existing Aml match step", "operationId": "5c798ba3e79dec5417587c12", "summary": "Exclude Aml Step", "parameters": [ { "name": "caseCommonId", "in": "path", "required": true, "type": "number" }, { "name": "stepId", "in": "path", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "casestepsCaseCommonIdExcludeStepIdPatchRequest", "in": "body", "schema": { "$ref": "#/definitions/CasestepsCaseCommonIdExcludeStepIdPatchRequest" }, "description": "\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
NameDescriptionMandatory
isExcludedboolean to change Excluded state of the Aml match stepYes
" } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Returns same result as step in single result of Case Steps action." }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Internal Error", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/casecomments": { "get": { "description": "Get case comments by case commonId", "operationId": "get-case-comments", "summary": "Get Case Comments", "parameters": [ { "name": "caseCommonId", "in": "query", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "type": "string" } ], "responses": { "200": { "description": "Returns case common \n", "examples": { "application/json": "[\n{\n\"CaseCommentId\":123,\n\"CaseCommonId\":123456,\n\"Comment\":\"Some comment\",\n\"CreationDate\":\"2019-02-14T14:51:28.333\",\n\"Author\":\"This guy\",\n\"IsAbleToDelete\":true\n},\n{\n\"CaseCommentId\":124,\n\"CaseCommonId\":123456,\n\"Comment\":\"Another comment\",\n\"CreationDate\":\"2019-02-14T14:51:28.333\",\n\"Author\":\"Another guy\",\n\"IsAbleToDelete\":false\n}\n]" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/casesteps/{caseCommonId}/status/{stepId}": { "patch": { "description": "Update status of an existing step", "operationId": "5c797d9fd5b796b8d7cc11bb", "summary": "Update Step Status", "parameters": [ { "name": "caseCommonId", "in": "path", "required": true, "type": "number" }, { "name": "stepId", "in": "path", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "casestepsCaseCommonIdStatusStepIdPatchRequest", "in": "body", "schema": { "$ref": "#/definitions/CasestepsCaseCommonIdStatusStepIdPatchRequest" }, "description": "\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
NameDescriptionMandatory
statusPASSED, FAILED or NOTREVIEWEDNo
isCollapsedboolean to change Collapsed state of the stepNo
" } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Returns same result as step in single result of Case Steps action." }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Internal Error", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/CaseStepNotes/{caseCommonId}/{stepId}": { "post": { "description": "Creates new note for a case step", "operationId": "5cc172283bd6ff88aa6d3759", "summary": "Add Case Step Note", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "stepId", "in": "path", "description": "Step identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "type": "string" }, { "name": "body-4", "in": "body", "schema": { "$ref": "#/definitions/Body-4" }, "description": "Body should contain model of case note that you want to create." } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Returns note that has just been created", "examples": { "application/json": { "id": 428, "username": "someuser@samplehost.net", "createdDateTime": "2019-04-25T08:59:19.7159891Z", "note": "Some note" } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/casestepnotes/{caseCommonId}/{stepId}": { "get": { "description": "Gets list of notes for a case step", "operationId": "5cc14677615f13d44801f9b2", "summary": "Case Step Notes", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "stepId", "in": "path", "description": "Step identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns a list of all notes for a case step specified", "schema": { "$ref": "#/definitions/" }, "examples": { "application/json": "[\n {\n \"id\": 412,\n \"username\": \"user1@host.com\",\n \"createdDateTime\": \"2019-04-14T12:45:17.693\",\n \"note\": \"some note text\"\n },\n {\n \"id\": 415,\n \"username\": \"user2@otherhost.net\",\n \"createdDateTime\": \"2019-04-14T13:03:46.407\",\n \"note\": \"another note text\"\n }\n]" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] }, "delete": { "description": "Deletes case step notes", "operationId": "5cc171cacbe1d0be23563eec", "summary": "Delete Case Step Notes", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "stepId", "in": "path", "description": "Step identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "type": "string" }, { "name": "body-3", "in": "body", "schema": { "$ref": "#/definitions/Body-3" }, "description": "Body should contain array of case step note's IDs to be deleted" } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Returns a list of notes left after current operation", "examples": { "application/json": "[\n {\n \"id\": 412,\n \"username\": \"user1@host.com\",\n \"createdDateTime\": \"2019-04-14T12:45:17.693\",\n \"note\": \"some note text\"\n },\n {\n \"id\": 415,\n \"username\": \"user2@otherhost.net\",\n \"createdDateTime\": \"2019-04-14T13:03:46.407\",\n \"note\": \"another note text\"\n }\n]" } }, "400": { "description": "", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid DataType", "timeStamp": "7/28/2017 12:26:21 PM" } ] } } }, "401": { "description": "", "examples": { "application/json": { "statusCode": 401, "message": "Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API." } } }, "403": { "description": "", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/companies/{caseCommonId}/audittrail": { "get": { "description": "Get audit trail for company case.\n\nThe audit trail is the immutable list of steps and actions your users or the system has taken in order to verify a case. All entries are time stamped for accurate record keeping.", "operationId": "5cc151ff5bf57072e961f67e", "summary": "Get Company Audit Trail", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns list of audit trail objects\n", "examples": { "application/json": "[\n {\n \"createdOn\": \"2019-04-16T14:22:32.787\",\n \"message\": \"New KYC case number D0-D-132513 created for Sheila Ann Somerset linked to case D0-D-132303 on 2019-04-16 14:22:32\"\n },\n {\n \"createdOn\": \"2019-04-16T14:21:39.917\",\n \"message\": \"New incoming link to this case D0-D-132303 from case D0-D-132510 for Paul Raymond Davies on 2019-04-16 14:21:39\"\n },\n {\n \"createdOn\": \"2019-04-16T14:21:28.663\",\n \"message\": \"New KYC case number D0-D-132503 created for John Carter linked to case D0-D-132303 on 2019-04-16 14:21:28\"\n }\n]" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/individuals/{caseCommonId}/audittrail": { "get": { "description": "Get audit trail for individual case.\n\nThe audit trail is the immutable list of steps and actions your users or the system has taken in order to verify a case. All entries are time stamped for accurate record keeping.", "operationId": "5cc14d882dacf8fd9e5aff29", "summary": "Get Individual Audit Trail", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns list of audit trail objects\n", "examples": { "application/json": "[\n {\n \"createdOn\": \"2019-04-16T14:22:32.787\",\n \"message\": \"New KYC case number D0-D-132513 created for Sheila Ann Somerset linked to case D0-D-132303 on 2019-04-16 14:22:32\"\n },\n {\n \"createdOn\": \"2019-04-16T14:21:39.917\",\n \"message\": \"New incoming link to this case D0-D-132303 from case D0-D-132510 for Paul Raymond Davies on 2019-04-16 14:21:39\"\n },\n {\n \"createdOn\": \"2019-04-16T14:21:28.663\",\n \"message\": \"New KYC case number D0-D-132503 created for John Carter linked to case D0-D-132303 on 2019-04-16 14:21:28\"\n }\n]" } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/individuals/documents/prevalidate": { "post": { "description": "Pre-validates document for Individual case.", "operationId": "5cc817529a25ae3c882422aa", "summary": "Pre-validate Document for Individual Case", "parameters": [ { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "body", "in": "body", "schema": {}, "description": "Request body includes file you want to upload and form-data to describe uploaded document. PhotoId and selfie pre-validation is supported at the moment.\n\nDocument data:
\nfileCat - category of the file you want to upload. Should take photoid or selfie value. Mandatory field;\n\nname - document name. Mandatory field;\n" } ], "consumes": [ "multipart/form-data" ], "responses": { "200": { "description": "Array of validation errors. Empty if no errors found.", "schema": { "$ref": "#/definitions/" }, "examples": { "application/json": "[\"Low resolution\"]" } }, "400": { "description": "Invalid request parameters or photo id pre-validation failed", "examples": { "application/json": { "statusCode": 400, "message": "Api Errors", "apiErrors": [ { "description": "Face not recognized on document", "timeStamp": "4/25/2019 12:19:30 PM" }, { "description": "Identity document not recognized", "timeStamp": "4/25/2019 12:19:30 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/assignuser/{caseCommonId}/assign/{userId}": { "put": { "description": "Assigns specified user to a case", "operationId": "5d1b4d3ce57ece339fa8d3e4", "summary": "Assign User To Case", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "caseCommonId of the case to reassign", "required": true, "type": "string" }, { "name": "userId", "in": "path", "description": "Id of the user the case to be assignd to", "required": true, "type": "string" }, { "name": "ApiKey", "in": "header", "required": true, "type": "string" } ], "responses": { "200": { "description": "Returns an object with a message \"Case assigned to ...\"", "examples": { "application/json": { "message": "Case assigned to Vladyslav Fedoniuk" } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid Customer Match.", "timeStamp": "7/4/2019 4:07:14 PM" } ] } } }, "403": { "description": "Access denied", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/companies/{caseCommonId}/report": { "get": { "description": "Download Company Report", "operationId": "5d1b4b01ab5343e95cb6fb97", "summary": "Download Company Report", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Company report data\n\nwe can return `application/zip` or `application/pdf`" }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "statusCode": 401, "message": "Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API." } } } }, "produces": [ "application/json" ] } }, "/individuals/{caseCommonId}/report": { "get": { "description": "Download Individual Report", "operationId": "5d1b55936620b1d770e9a7f0", "summary": "Download Individual Report", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Individual report data\n\nwe can return `application/zip` or `application/pdf`" }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "statusCode": 401, "message": "Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API." } } } }, "produces": [ "application/json" ] } }, "/companies/{caseCommonId}/org-chart": { "get": { "description": "Gets the company structure of the company. The information returned is similar to what we display in \"VCD/Company Structure\" section. The application returns all members and the members of all its child cases grouped by the following:\n- Officers - the list of officers linked to the current case;\n- Shareholders - the list of shareholders linked to the current case;\n- Other - all other case members linked to the current case;\n", "operationId": "5d3ae8873277da54815850b1", "summary": "Organizational Chart", "parameters": [ { "name": "caseCommonId", "in": "path", "description": "Case Common identifier", "required": true, "type": "number" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" } ], "responses": { "200": { "description": "Company organizational structure.\n
\nAll returned collections (shareholders, officers and others) can include cases for individuals and companies.\nEach member result object contains:\n- shares - integer containing the number of shares or not present if none or zero.\n- role - the role for members from the officers;\n- caseCommonId - the identifier of the case;\n- validation - true if the case is a company or false otherwise;\n-shareholders - The list of shareholders linked to the current company case or company case member. For each shareholder we include the same information;\n-officers - The list of officers linked to the current company case or company case member. For each officer we include the same information;\n-others - All other case members that are linked to the current case as anything but shareholder and officer. For each member we include the same information;\n\n", "schema": { "$ref": "#/definitions/ChartMember" }, "examples": { "application/json": { "validation": true, "caseCommonId": 16985, "name": "Company Test Limited LIMITED", "shareholders": [ { "validation": true, "shares": 100.0, "caseCommonId": 16864, "name": "Company Shareholder Limited LIMITED", "shareholders": [], "officers": [ { "role": "LLP Member", "validation": false, "caseCommonId": 16889, "name": "Shareholder Test", "shareholders": [], "officers": [], "others": [] }, { "role": "LLP Member", "validation": false, "caseCommonId": 16877, "name": "Shareholder II Test", "shareholders": [], "officers": [], "others": [] } ], "others": [] } ], "officers": [ { "role": "Director", "validation": false, "caseCommonId": 17016, "name": "Officer Test", "shareholders": [], "officers": [], "others": [] }, { "role": "Secretary", "validation": false, "caseCommonId": 17013, "name": "Officer II Test", "shareholders": [], "officers": [], "others": [] } ], "others": [] } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid CaseCommonId", "timeStamp": "7/25/2017 12:26:21 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/parseId": { "post": { "description": "Verifies photo id document", "operationId": "5d0c85cd049aac58fdf933a1", "summary": "PhotoId Verification", "parameters": [ { "name": "caseCommonId", "in": "query", "description": "individual case common id", "type": "string" }, { "name": "ApiKey", "in": "header", "description": "", "required": true, "type": "string" }, { "name": "body", "in": "body", "schema": {}, "description": "Request body includes file with photo id document you want to verify. Optional caseCommonId query parameter can be used to specify individual case" } ], "consumes": [ "multipart/form-data" ], "responses": { "200": { "description": "Photo Id document verification result", "schema": { "$ref": "#/definitions/UploadDocumentResult" }, "examples": { "application/json": { "caseCommonId": 16627, "caseDocumentId": 93349, "category": "photoid", "name": "Photo ID", "link": "https://kyc.azure-api.net/v2/documents/93349" } } }, "400": { "description": "Invalid request parameters or photo id pre-validation failed", "examples": { "application/json": { "statusCode": 400, "message": "Api Errors", "apiErrors": [ { "description": "Face not recognized on document", "timeStamp": "4/25/2019 12:19:30 PM" }, { "description": "Identity document not recognized", "timeStamp": "4/25/2019 12:19:30 PM" } ] } } }, "401": { "description": "Missing subscription key", "examples": { "application/json": { "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", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } }, "/user/list": { "post": { "description": "Searches for all the users registered in the system filtered by passed parameters structure", "operationId": "5d1b5235bcb7c71d21a4dd7a", "summary": "Users", "parameters": [ { "name": "ApiKey", "in": "header", "required": true, "type": "string" }, { "name": "", "in": "body", "schema": { "example": "{\n FullName: \"Sergey\",\n Email: \"ssv2@mailinator.com\",\n Active: false\n}" }, "description": "Body should contain representaion of search filter parameters:\n

    \n
  • \n FullName (optional) - FirstName LastName combination\n
  • \n
  • \n Email (optional) - email of the user\n
  • \n
  • \n Active (optional) - true or false indicator\n
  • \n
" } ], "consumes": [ "application/json" ], "responses": { "200": { "description": "Returns an object with an array of found users", "examples": { "application/json": { "list": [ { "fullName": "Sergey Sorokin", "email": "ssv2@mailinator.com", "role": "Administrator", "twoFactorAuthentication": false, "userId": "3e73fb5f-fa1a-4ee9-8105-78a7259a68ae", "active": false }, { "fullName": "Sergey Sorokin", "email": "ssv3@mailiantor.com", "role": "Administrator", "twoFactorAuthentication": false, "userId": "b675243d-a8a4-4ea2-a645-1e0cec8f4a8a", "active": false }, { "fullName": "Sergey Sorokin", "email": "ssv4@mailinator.com", "role": "Administrator", "twoFactorAuthentication": false, "userId": "e25e4feb-82b0-4cbc-a688-e68f9eb7ac6a", "active": false } ] } } }, "400": { "description": "Invalid request parameters", "examples": { "application/json": { "statusCode": 400, "message": "Api Error", "apiErrors": [ { "description": "Invalid request parameters", "timeStamp": "7/4/2019 4:15:18 PM" } ] } } }, "403": { "description": "Access denied", "examples": { "application/json": { "statusCode": 403, "message": "Access denied" } } } }, "produces": [ "application/json" ] } } }, "definitions": { "WorldCheckDetail": { "type": "object", "properties": { "category": { "type": "string" }, "firstName": { "type": "string" }, "lastName": { "type": "string" }, "dateOfBirth": { "type": "string" }, "placeOfBirth": { "type": "string" }, "citizenship": { "type": "string" }, "aliases": { "type": "string" }, "entered": { "type": "string" }, "externalMediaFound": { "type": "string" }, "furtherInformation": { "type": "string" }, "locations": { "type": "string" } } }, "LexisNexisChecksDetail": { "type": "object", "properties": { "category": { "type": "string" }, "firstName": { "type": "string" }, "lastName": { "type": "string" }, "dateOfBirth": { "type": "string" }, "placeOfBirth": { "type": "string" }, "occupation": { "type": "string" }, "entered": { "type": "string" }, "associations": { "type": "string" } } }, "IndividualAmlCheckDetail": { "type": "object", "properties": { "caseCommonId": { "type": "number" }, "firstName": { "type": "string" }, "lastName": { "type": "string" } } }, "CompanyAmlCheckDetail": { "type": "object", "properties": { "caseCommonId": { "type": "number" }, "lastName": { "type": "string" } } }, "IndividualAmlCheckResult": { "type": "object", "properties": { "individual": { "$ref": "#/definitions/IndividualAmlCheckDetail" }, "worldChecks": { "type": "array", "items": { "$ref": "#/definitions/WorldCheckDetail" } }, "lexisNexisChecks": { "type": "array", "items": { "$ref": "#/definitions/LexisNexisChecksDetail" } } } }, "CompanyAmlCheckResult": { "type": "object", "properties": { "company": { "$ref": "#/definitions/CompanyAmlCheckDetail" }, "worldChecks": { "type": "array", "items": { "$ref": "#/definitions/WorldCheckDetail" } }, "lexisNexisChecks": { "type": "array", "items": { "$ref": "#/definitions/LexisNexisChecksDetail" } } } }, "JurisdictionsResult": { "type": "object", "properties": { "jurisdictions": { "type": "object", "properties": { "jurisdiction": { "type": "array", "items": { "$ref": "#/definitions/Jurisdiction" } } } } } }, "Jurisdiction": { "type": "object", "properties": { "name": { "type": "string" }, "codeiso31662": { "type": "string" }, "area": { "type": "string" }, "isautomated": { "type": "boolean" } } }, "UploadDocumentResult": { "type": "object", "properties": { "caseCommonId": { "type": "number" }, "caseDocumentId": { "type": "number" }, "category": { "type": "string" }, "name": { "type": "string" }, "link": { "type": "string" } } }, "VerificationIndividualIdentityResult": { "type": "object", "properties": { "comparisonReport": { "type": "object", "properties": { "firstNameConfirmation": { "type": "object", "properties": { "value": { "type": "string" }, "recognizedValue": { "type": "string" }, "status": { "type": "string", "enum": [ "NotRecognized", "Missing", "Confirmed", "Deviates" ] } } }, "lastNameConfirmation": { "type": "object", "properties": { "value": { "type": "string" }, "recognizedValue": { "type": "string" }, "status": { "type": "string", "enum": [ "NotRecognized", "Missing", "Confirmed", "Deviates" ] } } }, "birthDateConfirmation": { "type": "object", "properties": { "badDateValueReason": { "type": "string" }, "value": { "type": "string" }, "recognizedValue": { "type": "string" }, "status": { "type": "string", "enum": [ "NotRecognized", "Missing", "Confirmed", "Deviates" ] } } } } }, "success": { "type": "boolean", "description": "True if document is verified" }, "message": { "type": "string", "description": "Information message" }, "triggeredRule": { "type": "object", "properties": { "scenario": { "type": "string", "description": "Unique rule id (for debug purposes)" }, "result": { "type": "string", "description": "Result type", "enum": [ "Valid", "Warning", "Fail" ] }, "message": { "type": "string", "description": "UI message key that explains the result", "enum": [ "DocumentPassedAuthentication", "AtLeastOneAuthenticationCheckFailed", "AtLeastOneForgeryIdentified", "DataElementsMistmach", "CouldNotPerformAuthenticationChecks", "CouldNotRecognizeDocument", "CouldNotRecognizeOrAuthenticateDocument", "DocumentIsExpired", "NotIdentityDocument", "DocumentIsBlackListed", "SomeElementsPreventedFullAuthenticationChecks", "DocumentRejected", "AtLeastOneAuthenticationCheckWasIndecisive", "NoAuthenticationChecksWerePerformed", "LowQualityDocument", "SomeAuthenticationChecksWereNotPerformed", "PagesDontMatch" ] }, "sensitivity": { "type": "string", "description": "Rule sensitivity level", "enum": [ "Low", "Medium", "High" ] }, "properties": { "type": "object", "properties": { "failUpload": { "type": "boolean", "description": "Is failure related to bad image quality and retaking the photo may improve the result" } } } } }, "imageQuality": { "type": "object", "properties": { "percentage": { "type": "integer", "description": "Image quality percentage" }, "value": { "type": "string", "description": "Image quality level", "enum": [ "Undefined", "VeryLow", "Low", "Average", "High", "Perfect" ] } } }, "forgeryTests": { "type": "array", "items": { "type": "object", "properties": { "group": { "type": "string", "description": "Forgery test group" }, "type": { "type": "string", "description": "Forgery test type" }, "result": { "type": "string", "description": "Forgery test result", "enum": [ "Authenticated", "Forged", "Unconclusive", "UnableToComplete", "NotRelevant" ] } } } }, "identityReport": { "type": "object", "properties": { "firstName": { "type": "string" }, "lastName": { "type": "string" }, "birthDate": { "type": "string" }, "sourceDocument": { "type": "string" }, "birthPlace": { "type": "string" }, "expiryDate": { "type": "string" }, "documentNumber": { "type": "string" }, "address": { "type": "string" } } } } }, "VerificationIdentityResult": { "type": "object", "properties": { "success": { "type": "boolean", "description": "True if document is verified" }, "message": { "type": "string", "description": "Information message" }, "triggeredRule": { "type": "object", "properties": { "scenario": { "type": "string", "description": "Unique rule id (for debug purposes)" }, "result": { "type": "string", "description": "Result type", "enum": [ "Valid", "Warning", "Fail" ] }, "message": { "type": "string", "description": "UI message key that explains the result", "enum": [ "DocumentPassedAuthentication", "AtLeastOneAuthenticationCheckFailed", "AtLeastOneForgeryIdentified", "DataElementsMistmach", "CouldNotPerformAuthenticationChecks", "CouldNotRecognizeDocument", "CouldNotRecognizeOrAuthenticateDocument", "DocumentIsExpired", "NotIdentityDocument", "DocumentIsBlackListed", "SomeElementsPreventedFullAuthenticationChecks", "DocumentRejected", "AtLeastOneAuthenticationCheckWasIndecisive", "NoAuthenticationChecksWerePerformed", "LowQualityDocument", "SomeAuthenticationChecksWereNotPerformed", "PagesDontMatch" ] }, "sensitivity": { "type": "string", "description": "Rule sensitivity level", "enum": [ "Low", "Medium", "High" ] }, "properties": { "type": "object", "properties": { "failUpload": { "type": "boolean", "description": "Is failure related to bad image quality and retaking the photo may improve the result" } } } } }, "imageQuality": { "type": "object", "properties": { "percentage": { "type": "integer", "description": "Image quality percentage" }, "value": { "type": "string", "description": "Image quality level", "enum": [ "Undefined", "VeryLow", "Low", "Average", "High", "Perfect" ] } } }, "forgeryTests": { "type": "array", "items": { "type": "object", "properties": { "group": { "type": "string", "description": "Forgery test group" }, "type": { "type": "string", "description": "Forgery test type" }, "result": { "type": "string", "description": "Forgery test result", "enum": [ "Authenticated", "Forged", "Unconclusive", "UnableToComplete", "NotRelevant" ] } } } }, "identityReport": { "type": "object", "properties": { "firstName": { "type": "string" }, "lastName": { "type": "string" }, "birthDate": { "type": "string" }, "sourceDocument": { "type": "string" }, "birthPlace": { "type": "string" }, "expiryDate": { "type": "string" }, "documentNumber": { "type": "string" }, "address": { "type": "string" } } } } }, "ChinaVerificationResult": { "type": "object", "properties": { "verified": { "type": "boolean" }, "message": { "type": "string" } } }, "CaseCommon": { "type": "object", "properties": { "caseCommonId": { "type": "integer" }, "caseCustomerId": { "type": "integer" }, "customerId": { "type": "integer" }, "customerName": { "type": "string" }, "type": { "type": "integer" }, "typeString": { "type": "string", "enum": [ "Company", "Individual" ] }, "scoring": { "type": "integer" }, "complete": { "type": "integer" }, "edit": { "type": "boolean", "description": "Don't use this property. It's deprecated and will be deleted since next version." }, "status": { "type": "string", "enum": [ "Open", "Closed" ] }, "statusChangedDatetime": { "type": "string" }, "statusChangedBy": { "type": "string" }, "statusId": { "type": "integer" }, "isVisible": { "type": "boolean" }, "creatorId": { "type": "string" }, "creatorUserName": { "type": "string" }, "createdDatetime": { "type": "string" }, "updatedBySystem": { "type": "string" }, "isAMLCase": { "type": "boolean" }, "updatedByUser": { "type": "string" }, "customerDepartmentId": { "type": "integer" }, "customerDepartmentName": { "type": "string" }, "countryRisk": { "type": "number" }, "assignedUserId": { "type": "string" }, "assignedUserName": { "type": "string" }, "link": { "type": "string" } } }, "CaseCompany": { "type": "object", "properties": { "id": { "type": "integer" }, "caseCompanyId": { "type": "integer" }, "caseCommonId": { "type": "integer" }, "countryCodeISO31662": { "type": "string" }, "entityName": { "type": "string" }, "type": { "type": "string" }, "description": { "type": "string" }, "userId": { "type": "string" }, "creatorId": { "type": "string" }, "createdDatetime": { "type": "string" }, "properties": { "type": "object" } } }, "CaseIndividual": { "type": "object", "properties": { "caseIndividualId": { "type": "integer" }, "firstName": { "type": "string" }, "lastName": { "type": "string" }, "caseCommonId": { "type": "integer" }, "countryCodeISO31662": { "type": "string" }, "country": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" }, "nationalityCountryCodeISO31662": { "type": "string" }, "nationalityCountry": { "type": "string" }, "creatorId": { "type": "string" }, "createdDatetime": { "type": "string" }, "properties": { "type": "object" } } }, "CompaniesSearchResult": { "type": "object", "properties": { "companySearch": { "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": { "rawname": { "type": "string" }, "externalCode": { "type": "string" }, "rawAddress": { "type": "string" }, "companyStatus": { "type": "string" } } } } } } } }, "CaseDetailResult": { "type": "object", "properties": { "caseDetail": { "type": "object", "properties": { "details": { "type": "object", "properties": { "common": { "$ref": "#/definitions/CaseCommon" }, "isCaseAMLPositive": { "type": "boolean" }, "company": { "$ref": "#/definitions/CaseCompany" }, "caseAddress": { "$ref": "#/definitions/CaseAddress" } } } } } } }, "CaseDetailImportResult": { "type": "object", "properties": { "details": { "type": "object", "properties": { "common": { "$ref": "#/definitions/CaseCommon" }, "company": { "$ref": "#/definitions/CaseCompany" }, "caseAddress": { "$ref": "#/definitions/CaseAddress" } } } } }, "CompaniesList": { "type": "array", "items": { "type": "object", "properties": { "common": { "$ref": "#/definitions/CaseCommon" }, "isCaseAMLPositive": { "type": "boolean" }, "company": { "$ref": "#/definitions/CaseCompany" }, "caseAddress": { "$ref": "#/definitions/CaseAddress" } } } }, "IndividualsList": { "type": "array", "items": { "type": "object", "properties": { "common": { "$ref": "#/definitions/CaseCommon" }, "isCaseAMLPositive": { "type": "boolean" }, "company": { "$ref": "#/definitions/CaseIndividual" }, "caseAddress": { "$ref": "#/definitions/CaseAddress" } } } }, "IndividualCaseDetailResult": { "type": "object", "properties": { "caseDetail": { "type": "object", "properties": { "details": { "type": "object", "properties": { "common": { "$ref": "#/definitions/CaseCommon" }, "isCaseAMLPositive": { "type": "boolean" }, "individual": { "$ref": "#/definitions/CaseIndividual" }, "caseAddress": { "$ref": "#/definitions/CaseAddress" } } } } } } }, "DataTypesResult": { "type": "array", "items": { "type": "string" } }, "CasePropertiesArrayBodyCompanies": { "type": "array", "items": { "$ref": "#/definitions/CaseProperty" }, "example": "[{\n \"dataType\": \"Activity Type\",\n \"data\": \"Any type\"\n},\n{\n \"dataType\": \"Other Names\",\n \"data\": \"Test Limited\"\n}]" }, "CasePropertiesArrayResult": { "type": "array", "items": { "$ref": "#/definitions/CaseProperty" } }, "CasePropertiesArrayBodyIndividual": { "type": "array", "items": { "$ref": "#/definitions/CaseProperty" }, "example": "[{\n \"dataType\": \"Birth Date\",\n \"data\": \"01/01/1990\"\n}]" }, "LinkCaseToCompanyBody": { "type": "object", "properties": { "relationType": { "type": "string", "enum": [ "Officer", "Shareholder" ] }, "relationRole": { "type": "string" }, "shares": { "type": "integer" } }, "example": "{\n \"relationType\": \"Shareholder\",\n \"relationRole\": \"Shareholder\",\n \"shares\": 50000\n}" }, "LinkCaseToIndividualBody": { "type": "object", "properties": { "relationType": { "type": "string" } }, "example": "{\n \"relationType\": \"Agent\"\n}" }, "LinkCaseToIndividualResult": { "type": "object", "properties": { "success": { "type": "boolean" }, "relationshipDescriptions": { "type": "array", "items": { "type": "string" } } } }, "CaseProperty": { "type": "object", "properties": { "dataType": { "type": "string" }, "data": { "type": "string" } } }, "DocumentWithDocumentId": { "type": "object", "properties": { "caseDocumentId": { "type": "integer" }, "category": { "type": "string" }, "name": { "type": "string" }, "link": { "type": "string" } } }, "IndividualDocumentsResult": { "type": "array", "items": { "$ref": "#/definitions/DocumentWithDocumentId" } }, "CompanyDocumentsResult": { "type": "object", "properties": { "caseCommonId": { "type": "number" }, "name": { "type": "string" }, "documents": { "type": "object", "properties": { "groupName": { "description": "This property can have name such as Company Identity Documents, Other Company Documents, etc", "type": "array", "items": { "$ref": "#/definitions/Document" } } } }, "controllingEntitiesAndIndividuals": { "type": "array", "items": { "type": "object", "properties": { "caseCommonId": { "type": "string" }, "name": { "type": "string" }, "documents": { "type": "object", "properties": { "groupName": { "description": "This property can have name such as Company Identity Documents, Other Company Documents, etc", "type": "array", "items": { "$ref": "#/definitions/Document" } } } } } } }, "shareholdersAndBeneficialOwners": { "type": "array", "items": { "type": "object", "properties": { "caseCommonId": { "type": "string" }, "name": { "type": "string" }, "documents": { "type": "object", "properties": { "groupName": { "description": "This property can have name such as Company Identity Documents, Other Company Documents, etc", "type": "array", "items": { "$ref": "#/definitions/Document" } } } } } } } } }, "Document": { "type": "object", "properties": { "link": { "type": "string" }, "category": { "type": "string" }, "name": { "type": "string" } } }, "CaseMembersResult": { "type": "object", "properties": { "controllingEntitiesAndIndividualsTitle": { "type": "string" }, "controllingEntitiesAndIndividuals": { "type": "array", "items": { "allOf": [ { "$ref": "#/definitions/CompanyMember" }, { "$ref": "#/definitions/IndividualMember" } ] } }, "shareholdersAndBeneficialOwnersTitle": { "type": "string" }, "shareholdersAndBeneficialOwners": { "type": "array", "items": { "allOf": [ { "$ref": "#/definitions/CompanyMember" }, { "$ref": "#/definitions/IndividualMember" } ] } }, "ultimateBeneficialOwnersTitle": { "type": "string" }, "ultimateBeneficialOwners": { "type": "array", "items": { "allOf": [ { "$ref": "#/definitions/UBOSMember" } ] } } } }, "UBOSMember": { "type": "object", "properties": { "sharesPercentage": { "type": "integer" }, "isCaseAMLPositive": { "type": "boolean" }, "member": { "allOf": [ { "$ref": "#/definitions/Member" }, { "type": "object", "properties": { "entityName": { "type": "string" } } } ] }, "memberType": { "type": "string", "enum": [ "Individual" ] }, "isKYCed": { "type": "boolean" } } }, "CompanyMember": { "type": "object", "properties": { "shares": { "type": "integer" }, "isCaseAMLPositive": { "type": "boolean" }, "member": { "allOf": [ { "$ref": "#/definitions/Member" }, { "type": "object", "properties": { "entityName": { "type": "string" } } } ] }, "memberType": { "type": "string", "enum": [ "Individual", "Company" ] }, "isKYCed": { "type": "boolean" } } }, "IndividualMember": { "type": "object", "properties": { "role": { "type": "string" }, "isCaseAMLPositive": { "type": "boolean" }, "member": { "allOf": [ { "$ref": "#/definitions/Member" }, { "type": "object", "properties": { "firstName": { "type": "string" }, "lastName": { "type": "string" }, "residenceCountry": { "type": "string" } } } ] }, "memberType": { "type": "string", "enum": [ "Individual", "Company" ] }, "isKYCed": { "type": "boolean" } } }, "Member": { "type": "object", "properties": { "caseCommonId": { "type": "integer" }, "jurisdictionId": { "type": "integer" }, "codeISO31662": { "type": "string" }, "address": { "$ref": "#/definitions/CaseAddress" }, "properties": { "type": "object", "description": "Dynamic properties. Dataset depends from jurisdiction." } } }, "CaseAddress": { "type": "object", "properties": { "caseAddresId": { "type": "integer" }, "caseCommonId": { "type": "integer" }, "addressLine1": { "type": "string" }, "addressLine2": { "type": "string" }, "city": { "type": "string" }, "stateProvince": { "type": "string" }, "postcode": { "type": "string" }, "country": { "type": "string" }, "countryCodeISO31662": { "type": "string" }, "countryId": { "type": "integer" }, "rawAddress": { "type": "string" }, "address": { "type": "string" }, "userId": { "type": "string" }, "creatorName": { "type": "string" }, "createdDatetime": { "type": "string" }, "deviceLng": { "type": "string" }, "deviceLat": { "type": "string" }, "geolocationVerified": { "type": "string" } } }, "DocumentsRequestResult": { "type": "object", "properties": { "uploadUrl": { "type": "string" }, "accessCode": { "type": "string" }, "emailSent": { "type": "boolean" }, "smsSent": { "type": "boolean" } } }, "DocumentsRequestBody": { "type": "object", "properties": { "documents": { "type": "array", "items": { "type": "string" } }, "email": { "type": "string" }, "phone": { "type": "string" } } }, "DocumentsRequestBodyCompany": { "type": "object", "$ref": "#/definitions/DocumentsRequestBody", "example": "{\n \"documents\": [\"NEWINC\", \"Annual Accounts\"],\n \"email\": \"example@example.com\",\n \"phone\": \"\",\n \"allowEdit\": true\n}" }, "DocumentsRequestBodyIndividual": { "type": "object", "$ref": "#/definitions/DocumentsRequestBody", "example": "{\n \"documents\": [\"photoid\"],\n \"email\": \"\",\n \"phone\": \"\",\n \"allowEdit\": true\n}" }, "DocumentCategories": { "type": "array", "items": { "type": "string" } }, "CaseSearchBody": { "type": "object", "properties": { "codeiso31662": { "type": "string" }, "query": { "type": "string" } }, "example": "{\n \"codeiso31662\" : \"GB\",\n \"query\": \"Test\"\n}" }, "ChinaBody": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" } }, "example": "{ \"id\" : \"513231200001010134\", \"name\" : \"潮安\" }" }, "CreateCaseBody": { "type": "object", "properties": { "rawname": { "type": "string" }, "externalCode": { "type": "string" }, "codeiso31662": { "type": "string" }, "entityType": { "type": "string" }, "companyType": { "type": "string" } }, "example": "{\n \"codeiso31662\": \"GB\",\n \"entityName\": \"UNITED ACCESS SERVICES LIMITED\",\n \"entityType\": \"Company\",\n \"companyType\": \"Private company limited by shares\",\n \"addressLine1\": \"Green st.\",\n \"addressLine2\": \"10\",\n \"postcode\": \"385493\",\n \"city\": \"Garlem\",\n \"countryCodeiso31662\": \"IE\"\n}" }, "ImportAddressModel": { "type": "object", "properties": { "addressLine1": { "type": "string" }, "addressLine2": { "type": "string" }, "postcode": { "type": "string" }, "city": { "type": "string" }, "province": { "type": "string" }, "codeiso31662": { "type": "string" }, "type": { "type": "string" }, "rawAddress": { "type": "string" } } }, "ImportCompanyCaseBody": { "type": "object", "properties": { "entityName": { "type": "string" }, "codeiso31662": { "type": "string" }, "companyType": { "type": "string" }, "properties": { "type": "array", "items": { "$ref": "#/definitions/CaseProperty" } }, "address": { "type": "object", "$ref": "#/definitions/ImportAddressModel" } }, "example": "{\n \"entityName\": \"TEST AIR SERVICES LTD\",\n \"codeiso31662\": \"GB\",\n \"companyType\": \"Private company limited by shares\",\n \"address\": {\n \t\"codeiso31662\": \"GB\",\n \"rawAddress\": \"96 96 Pelhurst Road, Ryde, Isle Of Wight, England\"\n },\n \"properties\": [{\n \t\"dataType\": \"Company Status\",\n \t\"data\": \"Active\"\n },\n {\n \t\"dataType\": \"Registration Number\",\n \t\"data\": \"11111111\"\n }],\n \"journeyName\": \"All\"\n}" }, "CreateIndividualCaseBody": { "type": "object", "properties": { "firstName": { "type": "string" }, "lastName": { "type": "string" }, "nationalityCodeiso31662": { "type": "string" }, "birthDate": { "type": "string" }, "addressLine1": { "type": "string" }, "addressLine2": { "type": "string" }, "postcode": { "type": "string" }, "city": { "type": "string" }, "province": { "type": "string" }, "countryCodeiso31662": { "type": "string" }, "properties": { "type": "array", "items": { "$ref": "#/definitions/CaseProperty" } } }, "example": "{\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"nationalityCodeiso31662\": \"GB\",\n \"birthDate\": \"01/01/1980\",\n \"addressLine1\": null,\n \"addressLine2\": null,\n \"postcode\": null,\n \"city\": null,\n \"province\": null,\n \"countryCodeiso31662\": null,\n \"properties\": [{\n \"dataType\": \"BirthDate\",\n \"data\": \"01/01/1990\"\n }],\n \"journeyName\": \"All\"\n}" }, "Body": {}, "Body-1": {}, "IndividualsCaseCommonIdStatusPatchRequest": { "example": "{\n\t\"status\" : \"Closed\"\n}" }, "CasestepsCaseCommonIdStatusStepIdPatchRequest": { "example": "{\n\t\"status\" : \"Passed\",\n\t\"isCollapsed\" : false\n}" }, "CasestepsCaseCommonIdExcludeStepIdPatchRequest": { "example": "{\n\t\"isExcluded\" : false\n}" }, "Body-2": { "example": "{\n \"CaseCommonId\": 123456,\n \"Comment\": \"Some comment\"\n}" }, "CompaniesCaseCommonIdStatusPatchRequest": { "example": "{\n\t\"status\" : \"Closed\"\n}" }, "Body-3": { "example": "[231, 481]" }, "Body-4": { "example": "{\n \"Note\": \"Some note\"\n}" }, "Body-5": {}, "ChartMember": { "type": "object", "properties": { "shares": { "type": "integer" }, "role": { "type": "string" }, "validation": { "type": "boolean" }, "caseCommonId": { "type": "integer" }, "name": { "type": "string" }, "shareholders": { "type": "array", "items": { "allOf": [ { "$ref": "#/definitions/ChartMember" } ] } }, "officers": { "type": "array", "items": { "allOf": [ { "$ref": "#/definitions/ChartMember" } ] } }, "others": { "type": "array", "items": { "allOf": [ { "$ref": "#/definitions/ChartMember" } ] } } } } }, "tags": [] }