Consulta de estado de solicitud

GET

https://api.dev-firmaseguraec.com/middleware/signature-request/status

Última modificación:2026-02-25 17:36:48

Endpoint para la consulta de estado de solicitud de una firma regular.

Consulta por ID de solicitud o referencia de transacción

La consulta de solicitud puede ser tanto por el campo requestId como por referenceTransaction, en caso de no especificar ninguno de estos dos parámetros un error es devuelto. Si se especifican los dos, se priorizará siempre el campo requestId.

Solicitud

Parámetros de consulta

Respuestas

🟢200Éxito

application/json

Bodyapplication/json

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location 'https://api.dev-firmaseguraec.com/middleware/signature-request/status?requestId=e3ddd27d-9d77-4914-993b-6784cc444ae6&referenceTransaction=firma-001&includeValidationDetails=true'

Ejemplo de Respuesta

{
  "request": {
    "id": "75f0f5f7-6115-437b-ac2f-bb5578a55631",
    "distributorReferenceId": "02a62727-3692-468b-96c9-e0c9104fd944",
    "emailAddress": "test@gmail.com",
    "cellphoneNumber": "+5939987654321",
    "city": "QUITO",
    "countryCode": "ECU",
    "creationDate": "2025-09-26 16:18:47",
    "address": "Calle 1 entre Calle 2 N0000",
    "province": "PICHINCHA",
    "status": "GENERATED",
    "updatedDate": "2025-10-12 18:01:35",
    "documentType": "CI",
    "applicationType": "NATURAL_PERSON",
    "identificationNumber": "170000000",
    "referenceTransaction": "TEST-0001",
    "applicantName": "John Paul",
    "applicantLastName": "Doe",
    "applicantSecondLastName": "Smith",
    "identificationFrontReference": "0ffb131e-b11f-4c19-ad84-cacf0857dd59.png",
    "identificationBackReference": "3f52a415-a8a6-47a7-bd1c-8ffe2162072f.png",
    "identificationSelfieReference": "684860cd-21c5-41f8-9d98-33b68d697c6e.jpg",
    "authorizationVideoReference": "f17872c1-6e17-466b-8c2a-04e4478a2ce8.mp4",
    "period": "ONE_YEAR",
    "verificationType": "OTP",
    "validityPresenter": {
      "id": "37f6af8f-1d2c-4ba2-b2f2-da4e227fc51f",
      "period": "ONE_YEAR"
    }
  },
  "validation": {
    "record": {
      "id": "c21f8a41-21ca-4130-ba07-a4eecfdeccd1",
      "referenceRequestId": "75f0f5f7-6115-437b-ac2f-bb5578a55631",
      "status": "COMPLETED",
      "type": "BIOMETRICS",
      "creationDate": "2025-09-26 16:18:48",
      "updateDate": "2025-09-26 16:50:14",
      "requiredManualValidation": false,
      "allowManualValidation": true,
      "operator": {
        "id": "92757073-bd74-4262-a13f-cd099c3648c1",
        "suspended": false
      },
      "operatorAssignments": [
        {
          "id": "35a67802-9b45-4aad-a8c0-206aa5da024a",
          "startAssignmentDate": "2025-09-26 16:49:19",
          "validationRequestId": "c20f7a61-21ca-4130-ba07-a4eecfdabbd1",
          "operator": {
            "id": "92757073-bd74-4262-a13f-cd099c3648c1",
            "suspended": false
          }
        }
      ]
    },
    "isAutomatic": false,
    "errors": [
      {
        "code": "A02",
        "reason": "El documento ingresado no corresponde al último emitido por el registro civil",
        "validationType": "DOCUMENT_ENTITY",
        "createdAt": "2025-09-26 16:18:58",
        "managed": true
      }
    ],
    "observations": [
      {
        "id": "9cc23076-bf2f-4c4d-8f05-c0ffa6dce439",
        "type": "INFO",
        "message": "test",
        "createdAt": "2025-10-12 17:56:26",
        "operator": {
          "id": "92757073-bd74-4262-a13f-cd099c3648c1",
          "suspended": false
        }
      }
    ]
  },
  "revocation": {
    "certificateApplicationId": "6b999364-cc84-43e9-ac7c-b4b6db1fcf75",
    "description": "Cambiado a Firma de 2 años",
    "createdDate": "2025-10-12 19:49:46",
    "updatedDate": "2025-10-12 19:49:46",
    "status": "APPROVED"
  },
  "timeDetails": {
    "certificateGeneratedAt": "2025-10-12 18:01:32",
    "certificateRevokedAt": "2025-10-12 19:49:46",
    "certificateValidFrom": "2025-03-19 19:44:07",
    "certificateValidUntil": "2026-03-19 20:44:07",
    "lastOperatorAssignedAt": "2025-09-26 16:49:19",
    "requestCreatedAt": "2025-09-26 16:18:47",
    "requestUpdatedAt": "2025-10-12 18:01:35",
    "validationApprovedAt": "2025-09-26 16:50:14",
    "validationCompletedAt": "2025-09-26 16:50:17",
    "validationStartedAt": "2025-09-26 16:18:48"
  },
  "requestType": "REGULAR_REQUEST"
}

Modificado en 2026-02-25 17:36:48

Registrar solicitud

Corrección de código dactilar y/o adjuntos

Consulta de estado de solicitud

Consulta por ID de solicitud o referencia de transacción#

Solicitud

Respuestas

Consulta por ID de solicitud o referencia de transacción