Consulta el estado de una solicitud de firmado

get/digital-signatures/signing-requests/{document-id}

Request

Base URL: https://api.datil.com (the document declares no server; this is the origin it was published from)
URL: https://api.datil.com/digital-signatures/signing-requests/{document-id}
Auth: none declared

Path parameters

document-idstring required

Identificador único de la solicitud de firmado.

Response

idstring required

Identificador de la solicitud de firmado.

environment'live' | 'test' required

Tipo de ambiente de la solicitud de firmado.

live: Ambiente de producción. test: Ambiente de pruebas.

statusstring required

Estatus del proceso de firma del documento:

draft: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.

processing: El documento fue enviado a los firmantes y el sistema está esperando que completen la firma.

signed: El documento ha sido firmado electrónicamente y puede ser descargado incluyendo las firmas de todos los firmantes.

Tipo de solicitud de firmado: ec/advanced: Firma electrónica avanzada y cualificada, de acuerdo a Ley de Comercio Electrónico, Firmas Electrónicas y Mensajes de Datos de Ecuador.

jm/advanced: Firma electrónica avanzada con validez legal en Jamaica.

pa/simple: Firma digital simple, de acuerdo a la Ley de Firmas y Certificados Digitales de Panamá.

pe/advanced: Firma digital simple y/o avanzada, de acuerdo a la Ley de Firmas y Certificados Digitales de Perú.

br/advanced: Firma digital avanzada con validez legal en Brasil.

bo/advanced: Firma digital avanzada con validez legal en Bolivia.

sv/advanced: Firma digital avanzada con validez legal en El Salvador.

gt/advanced: Firma digital avanzada con validez legal en Guatemala.

hn/advanced: Firma digital avanzada con validez legal en Honduras.

ni/advanced: Firma digital avanzada con validez legal en Nicaragua.

createdstring date-time required

Fecha de creación de la solicitud de firmado, en formato RFC3339.

signedstring date-time required

Fecha en que todos los firmantes firmaron el documento, en formato RFC3339.

Example response

{
  "id": "abc123",
  "status": "signed",
  "type": "ec/advanced",
  "created": "2026-10-07T17:29:46Z",
  "signed": "2026-10-07T17:29:46Z",
  "documents": [
    {
      "id": "1234",
      "title": "Documento de pruebas",
      "notes": "Nota interna de ejemplo.",
      "file_extension": "pdf",
      "original_file": "https://api.datil.com/d/abcds/pdf",
      "original_file_hash": "a9975509125e59f02fc36568a17608bf1268609f040b06600df4730fe94ef3b1",
      "signed_file": "https://api.datil.com/d/abcdef/pdf",
      "signed_file_hash": "38b58a284dbfc08180bf8a9693aa72ce749800dbb0f49a510b3fc71cf2d975c5",
      "signatures": [
        {
          "id": "1234",
          "timestamp": "2026-10-07T17:29:46Z",
          "signing_certificate": {
            "id": "0ca049e5-8d05-4d65-871a-82b6bdf508f7",
            "validity": 365,
            "created": "2022-01-01T00:00:00Z",
            "issued": "2022-01-01T00:00:00Z",
            "expiry": "2025-01-01T00:00:00Z",
            "serial_number": "11:22:22:22:00:22",
            "principal": {
              "first_name": "Juan",
              "middle_name": "Andres",
              "last_name": "Martinez",
              "second_last_name": "Lopez",
              "email": "prueba@prueba.com",
              "mobile_phone": "0999999999",
              "legal_id": "0922288828",
              "legal_id_type": {
                "type": "pe-ruc",
                "code": "6",
                "name": "RUC"
              },
              "position": "Gerente General",
              "tax_id": "0922288828001",
              "tax_id_type": {
                "type": "pe-ruc",
                "code": "6",
                "name": "RUC"
              },
              "address": {
                "line_1": "Calle A",
                "locality": "Lima",
                "administrative_district_level_1": "Miraflores",
                "administrative_district_level_2": "Lima",
                "city": "Lima",
                "province": "Lima",
                "tax_code": "0000",
                "country": {
                  "code": "PE",
                  "name": "Perú"
                }
              },
              "ip_address": "10.0.0.1",
              "user_agent": "WhatsApp",
              "proof_of_id": "https://portal.com/id/12345"
            },
            "status": "issued",
            "organization": {
              "legal_name": "Empresa S.A.",
              "tax_id_type": {
                "type": "pe-ruc",
                "code": "6",
                "name": "RUC"
              },
              "tax_id": "0922288828",
              "address": {
                "line_1": "Calle A",
                "locality": "Lima",
                "administrative_district_level_1": "Miraflores",
                "administrative_district_level_2": "Lima",
                "city": "Lima",
                "province": "Lima",
                "tax_code": "0000",
                "country": {
                  "code": "PE",
                  "name": "Perú"
                }
              },
              "position": "Gerente General"
            }
          },
          "signing_certificate_hash": "a9974509125e59f02fc36568a29608bf1268609f040b06600df4730fe94ef3b1",
          "page": "1",
          "size": "m",
          "x": "200",
          "y": "200"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.