🆔ID Document Verification

From a document you send us, we return the information contained in the document and a matching score performed with information from official databases.

Documents supported

All the below listed documents are supported. You will have to send us the front and/or the back image of the document. The answer will be send to you via a webhook. You will have to provide us the url to call for the webhook.

Document	Databases check
CNI (old)	✅
CNI	✅
Resident Card	✅
Consular Card
Passport
Driving License

Verify KYC Document images V1

POST /v1/clients-files/upload-files

Headers:

• Api-Key (required): provided by Danaya

• Api-Secret (required): provided by Danaya

• Content-Type (required): multipart/form-data

Request Body:

{
  "selfie": "file",
  "cniRecto": "file", // Front National ID image
  "cniVerso": "file", // Back National ID image
  "carteConsulaireRecto": "file", // Front Consular Card image
  "carteConsulaireVerso": "file", // Back Consular Card image
  "carteResidentRecto": "file", // Front Resident Card image
  "carteResidentVerso": "file", // Back Resident Card image
  "passport": "file" // Front Passport image
}

⚠️ supported image files are: png, jpeg and jpg

Responses:

The response will correspond to a document analysis request. The response ID can be used to retrieve the analysis result later see this page. The analysis result will also be sent via a webhook.

• OK:

  • Code: 200

  • Body

  {
      "id": "6a278893-6458-473f-9418-e1169fc7b",
      "createdAt": "2024-06-10 16:02:37",
      "addedBy": {},
      "clientFilesToAnalyzeDocuments": [
          {
              "id": "57327f5c-f67b-46ab-ae51-a6a455781",
              "type": "CNI",
              "jsonContent": null,
              "analyzed": false,
              "analyzedAt": null,
              "filesToAnalyse": [
                  {
                      "id": "648790a1-582f-414d-a372-f50a27f093d5",
                      "documentName": "CNI_back_87d93462-4b40-4f29-87ab-bb29cc8e_cni_recto.jpeg",
                      "extractedContent": null
                  },
                  {
                      "id": "39797276-470e-4620-9070-b99289425813",
                      "documentName": "CNI_front_25e2a9fd-f6bf-4600-87a7-7c523920_cni_recto.jpeg",
                      "extractedContent": null
                  }
              ]
          }
      ]
  }

• Code : 401

• Code: 400

Verify KYC Document images V2

POST /v2/clients-files/upload-files

The API accepts the following input parameters:

• selfie: A file representing the user's selfie image. This parameter is optional.

• idDocumentFront (required): A file containing the front side of the user's identification document.

• idDocumentBack: A file containing the back side of the user's identification document. This parameter is optional.

• documentType (required): Specifies the type of identification document. The available values are:

  • CNI (National ID Card)

  • PASSEPORT (Passport)

  • CARTE_RESIDENT (Resident Card)

  • CARTE_CONSULAIRE (Consular Card)

  • PERMIS_CONDUIRE (Driver’s License)

• verificationsToApply: An array specifying the types of verifications to be applied. The available values are:

  • DB_CHECK

  • MRZ_CHECK

  • EXPIRATION_CHECK

  • FACE_MATCH_CHECK

  • PEP_CHECK

  • SANCTION_CHECK

  • MEDIA_CHECK

  • TEMPLATE_CHECK

  • COMPANY_DB_CHECK

  If verificationsToApply is not defined or an empty array, all verifications configured on the company's account will be applied by default.

Headers:

• Api-Key (required): provided by Danaya

• Api-Secret (required): provided by Danaya

• Content-Type (required): multipart/form-data

Request Body:

{
  "selfie": "file",
  "idDocumentFront": "file", //(required)
  "idDocumentBack": "file",
  "externalId": "externalId in your system",
  "documentType": //(required) Available values : CNI, PASSEPORT, CARTE_RESIDENT, CARTE_CONSULAIRE, PERMIS_CONDUIRE 
  "verificationsToApply": []// Available values : DB_CHECK, MRZ_CHECK, EXPIRATION_CHECK, FACE_MATCH_CHECK, PEP_CHECK, SANCTION_CHECK, MEDIA_CHECK, TEMPLATE_CHECK, COMPANY_DB_CHECK
}

⚠️ supported image files are: png, jpeg and jpg

Responses:

The response will correspond to a document analysis request. The response ID can be used to retrieve the analysis result later see this page. The analysis result will also be sent via a webhook.

• OK:

  • Code: 200

  • Body

  {
      "id": "6a278893-6458-473f-9418-e1169fc7b",
      "createdAt": "2024-06-10 16:02:37",
      "addedBy": {},
      "externalId": "39797276-470e-4620-9070-b99289425813",
      "clientFilesToAnalyzeDocuments": [
          {
              "id": "57327f5c-f67b-46ab-ae51-a6a455781",
              "type": "CNI",
              "jsonContent": null,
              "analyzed": false,
              "analyzedAt": null,
              "filesToAnalyse": [
                  {
                      "id": "648790a1-582f-414d-a372-f50a27f093d5",
                      "documentName": "CNI_back_87d93462-4b40-4f29-87ab-bb29cc8e_cni_recto.jpeg",
                      "extractedContent": null
                  },
                  {
                      "id": "39797276-470e-4620-9070-b99289425813",
                      "documentName": "CNI_front_25e2a9fd-f6bf-4600-87a7-7c523920_cni_recto.jpeg",
                      "extractedContent": null
                  }
              ]
          }
      ]
  }

• Code : 401

• Code: 400