Kuenta Docs

Appearance

Obtener detalles de escaneo de firma​

GET
/document/{document-id}/signature-scan/{signature-id}

Recupera información detallada de un escaneo de firma específico, incluyendo su estado actual, metadata de la firma, y archivos asociados. Útil para seguimiento y auditoría del proceso de firma.

Authorizations​

bearerAuth

JWT token de autenticación. Utilice este esquema para autenticar solicitudes con un token JWT.

TypeHTTP (bearer)

Parameters​

Path Parameters

document-id*

ID único del documento

Typestring
Required
Example123e4567-e89b-12d3-a456-426614174000
formatuuid
signature-id*

ID único del escaneo de firma

Typestring
Required
Example789f0123-4567-89ab-cdef-012345678901
formatuuid

Responses​

Detalles del escaneo de firma obtenidos exitosamente
application/json
JSON
{
"success": true,
"message": "success",
"data": {
"signatureScanId": "789f0123-4567-89ab-cdef-012345678901",
"documentId": "123e4567-e89b-12d3-a456-426614174000",
"documentInfo": {
"documentName": "Contrato de Crédito - Juan Pérez",
"documentType": "credit_contract",
"pageCount": 5,
"fileSize": "2.5 MB"
},
"status": "string",
"signerInfo": {
"signerId": "456b7890-c123-45d6-e789-012345678901",
"signerName": "Juan Carlos Pérez García",
"signerEmail": "[email protected]",
"signerPhone": "+57 300 123 4567",
"documentType": "CC",
"documentNumber": "12345678",
"ipAddress": "192.168.1.100",
"userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 14_6 like Mac OS X)",
"geolocation": {
"latitude": 4.60971,
"longitude": -74.08175,
"city": "Bogotá",
"country": "Colombia"
}
},
"signatureDetails": {
"signatureType": "handwritten",
"signatureMethod": "touch_screen",
"signatureQuality": {
"score": 85.7,
"analysis": "Firma clara y bien definida",
"factors": [
[
"presion_adecuada",
"velocidad_consistente",
"trazos_completos"
]
]
},
"biometricData": {
"pressurePoints": [
[
0.5,
0.7,
0.9,
0.6,
0.4
]
],
"velocity": [
[
2.1,
1.8,
2.3,
1.9,
2
]
],
"acceleration": [
[
0.1,
-0.2,
0.3,
-0.1,
0
]
],
"duration": 3.45
}
},
"signatureFields": [
{
"fieldId": "signature_field_1",
"fieldName": "Firma del Deudor",
"pageNumber": 1,
"status": "string",
"signedAt": "2024-01-15T16:45:30Z",
"coordinates": {
"x": 100.5,
"y": 200.3,
"width": 150,
"height": 50
}
}
],
"validationResults": {
"otpValidation": {
"required": true,
"completed": true,
"validatedAt": "2024-01-15T16:40:00Z",
"attempts": 1,
"method": "sms"
},
"biometricValidation": {
"required": false,
"completed": false
},
"documentValidation": {
"identityVerified": true,
"documentNumberMatch": true,
"faceMatch": true,
"livenessDetected": true
}
},
"auditTrail": [
{
"timestamp": "2024-01-15T16:30:00Z",
"event": "signature_scan_created",
"description": "Escaneo de firma creado para documento",
"actor": "system",
"ipAddress": "192.168.1.100",
"metadata": {
}
}
],
"downloadLinks": {
"originalDocument": "https://api.kuenta.co/documents/123e4567-e89b-12d3-a456-426614174000/download",
"signedDocument": "https://api.kuenta.co/documents/123e4567-e89b-12d3-a456-426614174000/signed/download",
"signatureImage": "https://api.kuenta.co/signatures/789f0123-4567-89ab-cdef-012345678901/image",
"auditReport": "https://api.kuenta.co/signatures/789f0123-4567-89ab-cdef-012345678901/audit-report",
"certificate": "https://api.kuenta.co/signatures/789f0123-4567-89ab-cdef-012345678901/certificate"
},
"timestamps": {
"createdAt": "2024-01-15T16:30:00Z",
"sentAt": "2024-01-15T16:31:00Z",
"openedAt": "2024-01-15T16:35:00Z",
"signedAt": "2024-01-15T16:45:30Z",
"completedAt": "2024-01-15T16:46:00Z",
"expiresAt": "2024-01-15T17:30:00Z"
}
}
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI