Skip to main content
GET/api/conversations/{conversationId}/identity/metadata

Retrieving information about the metadata collected during the identification process

Returns information about the available metadata that was collected during the identification process.

Detailed description of returned fields:

ParameterExampleDescription
id9db8a804-4570-403e-9da6-162e608585e8Conversation ID.
letter-A structure representing the set of metadata collected from the identity validation process.
list.media-List of information about available multimedia files.
list.media.id7a4d1a9f-bdac-4d2c-96a6-bb51fb4ec7c5The ID of the media file.
list.media.typeDOCUMENTMedia file type. Possible values: DOCUMENT - document of the authenticated person, FACE - face of the authenticated person, REPORT - report on the verification process
list.media.subtypeID_CARDThe sub-type of the media file, such as the type of document. The value is blank if type = FACE. ID_CARD - identity card of the authenticated person, DRIVER_LICENSE - driving license of the authenticated person, PASSPORT - passport of the authenticated person, RESIDENCE_PERMIT - residence card of the authenticated person, UTILITY_BILL - proof of address of the authenticated person
list.media.variantFRONTVariant of the media file, e.g. document page. The value is blank if type = FACE. FRONT - front side of the document, BACK - back side of the document
list.media.contentTypeimage / pngThe type of media file content. Example values: image/png, video/mp4

Parameters

NameInTypeRequiredDescription
conversationIdpathstringRequired

Conversation ID

Responses

200

Information available

application/vnd.authologic.v1.1+json
idstring required

Conversation Id

listobject required

Metadata list, collected during the identification process

mediaarray<object> required

List of available media files

400

Bad Request

application/vnd.authologic.v1.1+json
One of:
Variant 1
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

Variant 2
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

Variant 3
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

Variant 4
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

Variant 5
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

Variant 6
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

Variant 7
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

402

Exhaustion of the plan or limitations related to non-payment

403

Permission denied

application/vnd.authologic.v1.1+json
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

404

Conversation not found

application/vnd.authologic.v1.1+json
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

410

Conversation is unavailable

application/vnd.authologic.v1.1+json
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

500

Server side error

Powered by Authologic Nisaba