Create a document

URL

POST https://api.complycube.com/v1/documents

Creates a new document.

Headers

Name	Type	Description
Content-Type*	string	The content-type must always be set to application/json.
Authorization*	string	The API live or test key.

Body

Name	Type	Description
clientId*	string	The ID of the client associated with this document.
type*	string	The type of document. Valid values include: 1. passport 2. driving_license 3. national_insurance_number 4. social_security_number 5. tax_identification_number 6. utility_bill 7. national_identity_card 8. visa 9. polling_card 10. residence_permit 11. birth_certificate 12. bank_statement 13. change_of_name 14. tax_document 15. company_confirmation_statement 16. company_annual_accounts 17. company_statement_of_capital 18. company_change_of_address 19. company_incorporation 20. company_change_of_officers 21. company_change_of_beneficial_owners 22. unknown 23. other
documentNumber	string	The document's number.
classification	string	The classification or purpose of this document. Valid values include: 1. proof_of_identity 2. source_of_wealth 3. source_of_funds 4. proof_of_address 5. company_filing 6. other
issuingCountry	string	The document's issuing country. This will be the two-letter country ISO code.
issuingState	string	The state that issued the document. This must be the state's USPS abbreviation (e.g. NY, CA, or DE).

Example request

cURL

curl -X POST https://api.complycube.com/v1/documents \
     -H 'Authorization: <YOUR_API_KEY>' \
     -H 'Content-Type: application/json' \
     -d '{
          	"clientId":"5eb1276d96be4a0008713af5",
          	"type": "driving_license",
          	"classification": "proof_of_identity",
          	"issuingCountry": "GB" 
        }'

Node.js

const { ComplyCube } = require("@complycube/api");

const complycube = new ComplyCube({ apiKey: "<YOUR_API_KEY>" });

const document = await complycube.document.create("CLIENT_ID", {
    type: "driving_license",
    classification: "proof_of_identity",
    issuingCountry: "GB"
});

Python

from complycube import ComplyCubeClient
cc_api = ComplyCubeClient(api_key='<YOUR_API_KEY>')

new_document = {
    'type': 'driving_license',
    'classification': 'proof_of_identity',
    'issuingCountry': 'GB'
}

doc = cc_api.documents.create('CLIENT_ID', **new_document)

PHP

use ComplyCube\ComplyCubeClient;

$ccapi = new ComplyCubeClient('<YOUR_API_KEY>');

$doc = $ccapi->documents()->create('CLIENT_ID', ['type' => 'passport']);

.NET

using ComplyCube.Net;
using ComplyCube.Net.Resources.Documents;

var docApi = new DocumentApi(new ComplyCubeClient("<YOUR_API_KEY>"));

var docRequest = new DocumentRequest {
  clientId = "CLIENT_ID",
  type = "passport",
  classification = "proof_of_identity",
  issuingCountry = "GB"
};

var document = await docApi.CreateAsync(docRequest);

Example responses

Success (200)

{
    "id": "5eb158880c19580007310f22",
    "clientId": "5eb1276d96be4a0008713af5",
    "type": "driving_license",
    "classification": "proof_of_identity",
    "issuingCountry": "GB",
    "createdAt": "2020-01-04T17:24:29.146Z",
    "updatedAt": "2020-01-04T17:24:29.146Z"
}

Invalid Request (400)

{
    "type": "invalid_request",
    "message": "'classification' should be equal to one of the allowed values: proof_of_identity,source_of_wealth,source_of_funds,proof_of_address,company_filing,other",
    "param": "classification"
}

Resource Not Found (404)

{
    "type": "resource_not_found",
    "message": "Invalid client id '5eb1276d96be4a0008713af2'"
}