Perform autofill

Extracts data and images from an identity document.

URL

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

Headers

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

Body

Name	Type	Description
data*	string	The BASE64 encoded data.

The response will include the following constituents:

• extractedData

• extractedImages

Example request

cURL

curl -X POST https://api.complycube.com/v1/autofill \
     -H 'Authorization: <YOUR_API_KEY>' \
     -H 'Content-Type: application/json' \
     -d '{
	       "data": "<BASE64_DATA_CONTENT>"
        }'

Node.js

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

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

const supportedDocuments = await complycube.autofill.performAutofill({
    data: "BASE64_DATA_CONTENT"
});

Example responses

Success (200)

{
  "extractedData": {
    "holderDetails": {
      "lastName": [
        "MUSTERMANN"
      ],
      "firstName": [
        "ERIKA"
      ],
      "dob": {
        "day": 12,
        "month": 8,
        "year": 1964
      },
      "age": 57,
      "nationality": "DE",
      "birthPlace": "BERLIN",
      "gender": "female"
    },
    "documentDetails": {
      "documentNumber": "C01X0006H",
      "documentType": "passport",
      "issuingCountry": "DE",
      "issuingAuthority": "STADT KÖLN",
      "issuingDate": {
        "day": 1,
        "month": 11,
        "year": 2007
      },
      "expirationDate": {
        "day": 31,
        "month": 10,
        "year": 2017
      },
      "hasTwoSides": false
    },
    "allExtractedData": {
      "visual": {
        "lastName": [
          "MUSTERMANN"
        ],
        "lastNameNative": "MUSTERMANN",
        "firstName": [
          "ERIKA"
        ],
        "firstNameNative": "ERIKA",
        "entityNameNative": "MUSTERMANN ERIKA",
        "dob": {
          "day": 12,
          "month": 8,
          "year": 1964
        },
        "nationalityNative": "DEUTSCH",
        "birthPlace": "BERLIN",
        "birthPlaceNative": "BERLIN",
        "gender": "female",
        "documentNumber": "C01X0006H",
        "issuingCountry": "DE",
        "issuingAuthority": "STADT KÖLN",
        "issuingAuthorityNative": "STADT KÖLN",
        "issuingDate": {
          "day": 1,
          "month": 11,
          "year": 2007
        },
        "expirationDate": {
          "day": 31,
          "month": 10,
          "year": 2017
        }
      },
      "mrz": {
        "lastName": [
          "MUSTERMANN"
        ],
        "firstName": [
          "ERIKA"
        ],
        "dob": {
          "day": 12,
          "month": 8,
          "year": 1964
        },
        "nationality": "DE",
        "gender": "female",
        "documentNumber": "C01X0006H",
        "issuingCountry": "DE",
        "expirationDate": {
          "day": 31,
          "month": 10,
          "year": 2017
        }
      }
    },
    "mrz": {
      "line1": "P<D<<MUSTERMANN<<ERIKA<<<<<<<<<<<<<<<<<<<<<<",
      "line2": "C01X0006H1D<<6408125F1710319<<<<<<<<<<<<<<<0"
    }
  },
  "extractedImages": [
    {
      "type": "front_side",
      "data": "<BASE64_DATA_CONTENT>"
    }
  ]
}

Unreadable Image (422)

{
    "type": 'document_type_undetected', 
    "message": 'Document type not recognized'
}