Certificados

Consulta un certificado

get/certificates/{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/certificates/{id}
  • Auth: none declared

Path parameters

idstring required

Identificador único del documento, generado por Dátil.

Response

OK

idstring uuid required

Identificador único del certificado, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.

type'ec/instant' | 'ec/individual' | 'ec/sole-proprietorship' | 'ec/business-director' | 'ec/business-employee' | 'ec/organization' | 'jm/instant' | 'pa/instant' | 'pe/instant' | 'br/instant' | 'bo/instant' | 'sv/instant' | 'gt/instant' | 'hn/instant' | 'ni/instant' required

Tipo de certificado: ec/instant: Certificado instantáneo con validez de 1 día, solo para personas naturales. ec/individual: Certificado para persona natural, solo con número de cédula. No incluye el RUC del titular.

ec/sole-proprietorship: Certificado para persona natural con RUC.

ec/business-director: Certificado para representante legal de una empresa.

ec/business-employee: Certificado para miembro de una empresa (ej. contador).

ec/organization: Certificado para representante legal de organizaciones públicas o privadas.

jm/instant: Certificado virtual para firma simple en Jamaica.

pe/instant: Certificado virtual para firma simple en Perú.

pa/instant: Certificado virtual para firma simple en Panamá.

br/instant: Certificado virtual para firma simple en Brasil.

bo/instant: Certificado virtual para firma simple en Bolivia.

sv/instant: Certificado virtual para firma simple en El Salvador.

gt/instant: Certificado virtual para firma simple en Guatemala.

hn/instant: Certificado virtual para firma simple en Honduras.

ni/instant: Certificado virtual para firma simple en Nicaragua.

environment'live' | 'test' required

Tipo de ambiente del certificado.

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

Los certificados en ambiente de pruebas simulan su emisión y las acciones que realices con ellos (ej. firmas electrónicas), por lo que no tienen costo.

Los certificados en ambiente de producción si se emiten y tienen costo.

validitynumber double required

Validez del certificado en días. Valores aceptados: 1, 365, 732, 1095, 1825

createdstring date-time required

Fecha de creación de la solicitud de emisión del certificado, en formato RFC3339.

issuedstring date-time required

Fecha de emisión del certificado, en formato RFC3339.

expirystring date-time required

Fecha de expiración del certificado, en formato RFC3339.

serial_numberstring

Serie del certificado.

statusstring required

Estado del certificado: issued, draft o processing.

Example response

{
  "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"
  }
}

Changes

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