Enroll Voice

To perform the user’s biometric voice enrollment, the method to be used is Enroll Voice. On this type of biometric analysis, we need several calls to this method in order to complete the enrollment step. On the first request to this method, the system will start the voice enrollment process returning the audio sample expected to be present on the next request (not expecting any file on the first request) and so on until the enrollment process is finished. In case of success, the user’s biometric voice registry will be created on the biometric engine chosen, allowing further identifications. In case of failure, it’s necessary to repeat this process until the enrollment is accepted.

Enroll Voice

POST Https://api.biometrid.com/api/1.1/users/:userId/dialogue/enroll/voice

Enroll user's voice on client's chosen provider.

Path Parameters

Name	Type	Description
userID	string	BiometrID user ID

Headers

Name	Type	Description
Content-type	string	Request content type (This is not required to be set. Referenced only to show how we expect data to be sent). { "Content-Type": "multipart/form-data" }
x-biometrid-key	string	Application Client Key
x-biometrid-secret	string	Application Client Secret

Request Body

Name	Type	Description
audio	object	Audio file with the voice biometrid sample. (only .wav format).

200 Success 200 types

HTTP/1.1 200 OK

//Dialogue Started
{
    "status": true,
    "data": {
      "message": "DIALOGUE_STARTED_WITH_SUCCESS",
      "enrollmentId": "5f199b5398a915637332dc23",
    }
}

// Audio Submitted (valid attempt)
{
    "status": true,
    "data": {
        "message": "VALID_ATTEMPT",
        "detail": "Valid attempt",
        "attempt": 1
    }
}

//Audio Enrolled
{
    "status": true,
    "data": {
      "message": "AUDIO_ENROLLED_WITH_SUCCESS",
      "enrolled": true
    }
}

//Voice Enrollment Failed
{
    "status": false,
    "data": {
        "message": "ENROLLMENT_FAILED",
        "detail": "Enrollment failed. Please start over.",
        "attempt": 4
      }
}

400 Bad Request types

HTTP/1.1 400 Bad Request

//No audio file detected on request. Not sent or invalid format.
{
    "status": false,
    "data": {
        "message": "NO_FILE_OR_INVALID_FORMAT"
    }
}
//User voice already enrolled.
{
    "status": false,
    "data": {
        "message": "USER_VOICE_ALREADY_ENROLLED"
    }
}
// Missing Headers
{
    "status": false,
    "data": {
        "message": "AUTHENTICATION_HEADERS_MISSING"
    }
}

401 Invalid Headers.

HTTP/1.1 401 Unauthorized

{
    "status": false,
    "data": {
        "message": "INVALID_AUTHENTICATION_HEADERS"
    }
}

402 Payment Required - Request Limit Reached for Client Plan.

HTTP/1.1 402 Payment Required

{
    "status": false,
    "data": {
        "message": "REQUEST_LIMIT_REACHED"
    }
}

404 Not Found request types

HTTP/1.1 404 Not Found

// No active engine configuration for this provider.
{
    "status": false,
    "data": {
        "message": "NO_VOICE_ENGINE_CONFIGURATION_AVAILABLE"
    }
}
 // User's id not exists in biometrid environment.
{
    "status": false,
    "data": {
        "message": "USERID_NOT_EXISTS"
    }
}
//Client not found by given key.
{
    "status": false,
    "data": {
        "message": "CLIENT_NOT_FOUND/CHECK_AUTHENTICATION_HEADERS"
    }
}