Registro Civil (v1.0)

Download OpenAPI description
Overview
Languages
Servers
Production

https://api.khipu.com/

Birth Certificate

Request

Este método retorna un "Certificado de nacimiento" desde el sitio web del Registro Civil, dado un Rol Único Nacional (RUN).

El uso del campo CallbackUrl desencadenará un proceso asíncrono y los datos resultantes se enviarán más tarde al webhook especificado. Esta es la forma preferida de interactuar con nuestros servicios, ya que asegura que se harán todos los esfuerzos para extraer los datos y cumplir con su solicitud dentro de un plazo razonable. Si desea la respuesta de inmediato, omita el campo CallbackUrl pero tenga en cuenta que puede provocar tiempos de espera dependiendo del tamaño del resultado de los datos y las condiciones de la red.

Security
JWT or Api-Key
Bodyapplication/jsonRequerido
RequestDataobjectrequerido

Información necesaria para conectarse a la cuenta del usuario en el sitio web y extraer datos. Los campos obligatorios indican los valores necesarios para identificar la cuenta deseada.

RolUnicoNacionalCertificatestring^\d{1,8}[-][0-9kK]{1}$requerido

Rol Único Nacional (RUN) de la persona para la cual solicitas el certificado de nacimiento, sin utilizar puntos.

Ejemplo: "11222333-k"
RolUnicoNacionalApplicantstring^\d{1,8}[-][0-9kK]{1}$requerido

Rol único nacional (RUN) de la persona solicitante del certificado. No utilice los puntos.

Ejemplo: "11222333-k"
DocumentNumberApplicantstring^\d{9,10}$requerido

Número de serie del documento de identidad de la persona que solicita el certificado.

Ejemplo: "555666777"
CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"
curl -i -X POST \
  https://api.khipu.com/v1/cl/services/registrocivil.cl/birth-certificate \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "RolUnicoNacionalCertificate": "11222333-k",
      "RolUnicoNacionalApplicant": "11222333-k",
      "DocumentNumberApplicant": "555666777"
    }
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json
OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"
Statusstringrequerido

Estado de la operación. OK significa que el servicio se ha ejecutado correctamente aunque no devuelva datos. ERROR indica que ha ocurrido algo que ha impedido la finalización con éxito del proceso.

Enum"OK""ERROR"
Ejemplo: "OK"
Dataobject or nullrequerido

Contenedor para certificado de nacimiento.

CertificadoNacimientoobjectrequerido

Contenedor para certificado de nacimiento.

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null
Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null
Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"
Typestring

Indica cómo tratar este código de error específico, en función del tipo de error.

Enum"RETRY_IMMEDIATELY""DO_NOT_RETRY""WAIT_4_HOURS_BEFORE_RETRY""RETRY_AFTER_NOTIFICATION"
Ejemplo: "RETRY_IMMEDIATELY"
Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."
LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null
Response
application/json
{ "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4", "Status": "OK", "Data": { "CertificadoNacimiento": { "Folio": "500515253001", "CodigoVerificacion": "c846470891ff", "FechaEmision": "2023-09-28T16:32:00", "DatosRegistro": { "Circunscripcion": "SAN JOSÉ DE MAIPO", "NumeroInscripcion": "9.821", "Registro": "E", "Anio": "1997", "NombreInscrito": "NOMBRE1 NOMBRE2 APELLIDO1 APELLIDO2", "Run": "11.222.333-7", "FechaNacimiento": "1980-04-25", "HoraNacimiento": "13:50:00", "Sexo": "Masculino", "NombrePadre": "NOMBRE1 NOMBRE2 APELLIDO1 APELLIDO2", "RunPadre": "11.222.333-7", "NombreMadre": "NOMBRE1 NOMBRE2 APELLIDO1 APELLIDO2", "RunMadre": "11.222.333-7", "CuidadoPersonalJudicial": "Custodia otorgada al padre A", "PatriaPotestadJudicial": "Autoridad parental compartida" }, "NombreArchivo": "MAT_500515253001_11222333.pdf", "Documento": "<document>" } }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }

Civil Union Certificate

Request

Este método retorna un "Certificado de Unión Civil" desde el sitio web del Registro Civil, dado un Rol Único Nacional (RUN).

El uso del campo CallbackUrl desencadenará un proceso asíncrono y los datos resultantes se enviarán más tarde al webhook especificado. Esta es la forma preferida de interactuar con nuestros servicios, ya que asegura que se harán todos los esfuerzos para extraer los datos y cumplir con su solicitud dentro de un plazo razonable. Si desea la respuesta de inmediato, omita el campo CallbackUrl pero tenga en cuenta que puede provocar tiempos de espera dependiendo del tamaño del resultado de los datos y las condiciones de la red.

Security
JWT or Api-Key
Bodyapplication/jsonRequerido
RequestDataobjectrequerido

Información necesaria para conectarse a la cuenta del usuario en el sitio web y extraer datos. Los campos obligatorios indican los valores necesarios para identificar la cuenta deseada.

RolUnicoNacionalCertificatestring^\d{1,8}[-][0-9kK]{1}$requerido

Rol único nacional (RUN) del que deseas el certificado de unión civil. No utilice los puntos.

Ejemplo: "11222333-k"
CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"
curl -i -X POST \
  https://api.khipu.com/v1/cl/services/registrocivil.cl/civil-union-certificate \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "RolUnicoNacionalCertificate": "11222333-k"
    }
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json
OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"
Statusstringrequerido

Estado de la operación. OK significa que el servicio se ha ejecutado correctamente aunque no devuelva datos. ERROR indica que ha ocurrido algo que ha impedido la finalización con éxito del proceso.

Enum"OK""ERROR"
Ejemplo: "OK"
Dataobject or nullrequerido

Contenedor para certificado de unión civil.

CertificadoUnionCivilobjectrequerido

Contenedor para certificado de unión civil.

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null
Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null
Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"
Typestring

Indica cómo tratar este código de error específico, en función del tipo de error.

Enum"RETRY_IMMEDIATELY""DO_NOT_RETRY""WAIT_4_HOURS_BEFORE_RETRY""RETRY_AFTER_NOTIFICATION"
Ejemplo: "RETRY_IMMEDIATELY"
Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."
LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null
Response
application/json
{ "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4", "Status": "OK", "Data": { "CertificadoUnionCivil": { "Folio": "500515253001", "CodigoVerificacion": "c846470891ff", "FechaEmision": "2023-09-28T16:32:00", "DatosRegistro": { "Circunscripcion": "SAN JOSÉ DE MAIPO", "NumeroInscripcion": "9.821", "FechaAnotacion": "2024-11-20T00:00:00", "Anio": "1997", "NombreConviviente1": "NOMBRE1 NOMBRE2 APELLIDO1 APELLIDO2", "RunConviviente1": "11.222.333-7", "FechaNacimientoConviviente1": "1980-04-25", "NombreConviviente2": "NOMBRE1 NOMBRE2 APELLIDO1 APELLIDO2", "RunConviviente2": "11.222.333-7", "FechaNacimientoConviviente2": "1980-04-25", "FechaCelebracion": "1980-04-25T11:00:00" }, "NombreArchivo": "MAT_500515253001_11222333.pdf", "Documento": "<document>" } }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }

Death Certificate

Request

Este método retorna un "Certificado de defunción" desde el sitio web del Registro Civil, dado un Rol Único Nacional (RUN).

El uso del campo CallbackUrl desencadenará un proceso asíncrono y los datos resultantes se enviarán más tarde al webhook especificado. Esta es la forma preferida de interactuar con nuestros servicios, ya que asegura que se harán todos los esfuerzos para extraer los datos y cumplir con su solicitud dentro de un plazo razonable. Si desea la respuesta de inmediato, omita el campo CallbackUrl pero tenga en cuenta que puede provocar tiempos de espera dependiendo del tamaño del resultado de los datos y las condiciones de la red.

Security
JWT or Api-Key
Bodyapplication/jsonRequerido
RequestDataobjectrequerido

Información necesaria para conectarse a la cuenta del usuario en el sitio web y extraer datos. Los campos obligatorios indican los valores necesarios para identificar la cuenta deseada.

RolUnicoNacionalCertificatestring^\d{1,8}[-][0-9kK]{1}$requerido

Rol único nacional (RUN) del que deseas el certificado de defunción. No utilice los puntos.

Ejemplo: "11222333-k"
RolUnicoNacionalApplicantstring^\d{1,8}[-][0-9kK]{1}$requerido

Rol único nacional (RUN) de la persona solicitante del certificado. No utilice los puntos.

Ejemplo: "11222333-k"
DocumentNumberApplicantstring^\d{9,10}$requerido

Número de serie del documento de identidad de la persona que solicita el certificado.

Ejemplo: "555666777"
CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"
curl -i -X POST \
  https://api.khipu.com/v1/cl/services/registrocivil.cl/death-certificate \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "RolUnicoNacionalCertificate": "11222333-k",
      "RolUnicoNacionalApplicant": "11222333-k",
      "DocumentNumberApplicant": "555666777"
    }
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json
OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"
Statusstringrequerido

Estado de la operación. OK significa que el servicio se ha ejecutado correctamente aunque no devuelva datos. ERROR indica que ha ocurrido algo que ha impedido la finalización con éxito del proceso.

Enum"OK""ERROR"
Ejemplo: "OK"
Dataobject or nullrequerido

Contenedor para certificado de defunción.

CertificadoDefuncionobjectrequerido

Contenedor para certificado de defunción.

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null
Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null
Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"
Typestring

Indica cómo tratar este código de error específico, en función del tipo de error.

Enum"RETRY_IMMEDIATELY""DO_NOT_RETRY""WAIT_4_HOURS_BEFORE_RETRY""RETRY_AFTER_NOTIFICATION"
Ejemplo: "RETRY_IMMEDIATELY"
Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."
LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null
Response
application/json
{ "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4", "Status": "OK", "Data": { "CertificadoDefuncion": { "Folio": "500515253001", "CodigoVerificacion": "c846470891ff", "FechaEmision": "2023-09-28T16:32:00", "DatosRegistro": { "Circunscripcion": "SAN JOSÉ DE MAIPO", "NumeroInscripcion": "9.821", "Registro": "E", "Anio": "1997", "NombreInscrito": "NOMBRE1 NOMBRE2 APELLIDO1 APELLIDO2", "Run": "11.222.333-7", "FechaNacimiento": "1980-04-25", "Sexo": "Masculino", "FechaDefuncion": "2023-09-28T16:32:00", "LugarDefuncion": "Santiago" }, "NombreArchivo": "MAT_500515253001_11222333.pdf", "Documento": "<document>" } }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }

Identity document validity check

Request

Este método retorna el estado en tiempo real de un documento de identidad chileno, dado un Rol Único Nacional (RUN), utilizando el sitio web del Registro Civil.

El uso del campo CallbackUrl desencadenará un proceso asíncrono y los datos resultantes se enviarán más tarde al webhook especificado. Esta es la forma preferida de interactuar con nuestros servicios, ya que asegura que se harán todos los esfuerzos para extraer los datos y cumplir con su solicitud dentro de un plazo razonable. Si desea la respuesta de inmediato, omita el campo CallbackUrl pero tenga en cuenta que puede provocar tiempos de espera dependiendo del tamaño del resultado de los datos y las condiciones de la red.

Security
JWT or Api-Key
Bodyapplication/jsonRequerido
RequestDataobjectrequerido

Información necesaria para conectarse a la cuenta del usuario en el sitio web y extraer datos. Los campos obligatorios indican los valores necesarios para identificar la cuenta deseada.

RolUnicoNacionalstring^\d{1,8}[-][0-9kK]{1}$requerido

Rol Único Nacional (RUN). No utilice los puntos.

Ejemplo: "11222333-k"
DocumentNumberstring^\d{9,10}$requerido

Número de serie del documento de identidad.

Ejemplo: "555666777"
DocumentTypestringrequerido

Tipo del documento que está siendo verificado.

Enum"Cédula""Pasaporte"
Ejemplo: "Cédula"
CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"
curl -i -X POST \
  https://api.khipu.com/v1/cl/services/registrocivil.cl/identity-document-validity-check \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "RolUnicoNacional": "11222333-k",
      "DocumentNumber": "555666777",
      "DocumentType": "Cédula"
    }
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json
OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"
Statusstringrequerido

Estado de la operación. OK significa que el servicio se ha ejecutado correctamente aunque no devuelva datos. ERROR indica que ha ocurrido algo que ha impedido la finalización con éxito del proceso.

Enum"OK""ERROR"
Ejemplo: "OK"
Dataobject or nullrequerido

Contenedor para el estado del documento.

DocumentStatusobjectrequerido

Contenedor para el estado del documento.

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null
Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null
Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"
Typestring

Indica cómo tratar este código de error específico, en función del tipo de error.

Enum"RETRY_IMMEDIATELY""DO_NOT_RETRY""WAIT_4_HOURS_BEFORE_RETRY""RETRY_AFTER_NOTIFICATION"
Ejemplo: "RETRY_IMMEDIATELY"
Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."
LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null
Response
application/json
{ "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4", "Status": "OK", "Data": { "DocumentStatus": { "RolUnicoNacional": "11222333-K", "Status": "VIGENTE" } }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }

Marriage Certificate

Request

Este método retorna un "Certificado de matrimonio" desde el sitio web del Registro Civil, dado un Rol Único Nacional (RUN).

El uso del campo CallbackUrl desencadenará un proceso asíncrono y los datos resultantes se enviarán más tarde al webhook especificado. Esta es la forma preferida de interactuar con nuestros servicios, ya que asegura que se harán todos los esfuerzos para extraer los datos y cumplir con su solicitud dentro de un plazo razonable. Si desea la respuesta de inmediato, omita el campo CallbackUrl pero tenga en cuenta que puede provocar tiempos de espera dependiendo del tamaño del resultado de los datos y las condiciones de la red.

Security
JWT or Api-Key
Bodyapplication/jsonRequerido
RequestDataobjectrequerido

Información necesaria para conectarse a la cuenta del usuario en el sitio web y extraer datos. Los campos obligatorios indican los valores necesarios para identificar la cuenta deseada.

RolUnicoNacionalCertificatestring^\d{1,8}[-][0-9kK]{1}$requerido

Rol único nacional (RUN) del que deseas el certificado de matrimonio. No utilice los puntos.

Ejemplo: "11222333-k"
RolUnicoNacionalApplicantstring^\d{1,8}[-][0-9kK]{1}$requerido

Rol único nacional (RUN) de la persona solicitante del certificado. No utilice los puntos.

Ejemplo: "11222333-k"
DocumentNumberApplicantstring^\d{9,10}$requerido

Número de serie del documento de identidad de la persona que solicita el certificado.

Ejemplo: "555666777"
CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"
curl -i -X POST \
  https://api.khipu.com/v1/cl/services/registrocivil.cl/marriage-certificate \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "RolUnicoNacionalCertificate": "11222333-k",
      "RolUnicoNacionalApplicant": "11222333-k",
      "DocumentNumberApplicant": "555666777"
    }
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json
OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"
Statusstringrequerido

Estado de la operación. OK significa que el servicio se ha ejecutado correctamente aunque no devuelva datos. ERROR indica que ha ocurrido algo que ha impedido la finalización con éxito del proceso.

Enum"OK""ERROR"
Ejemplo: "OK"
Dataobject or nullrequerido

Contenedor para certificado de matrimonio.

CertificadoMatrimonioobjectrequerido

Contenedor para certificado de matrimonio.

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null
Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null
Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"
Typestring

Indica cómo tratar este código de error específico, en función del tipo de error.

Enum"RETRY_IMMEDIATELY""DO_NOT_RETRY""WAIT_4_HOURS_BEFORE_RETRY""RETRY_AFTER_NOTIFICATION"
Ejemplo: "RETRY_IMMEDIATELY"
Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."
LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null
Response
application/json
{ "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4", "Status": "OK", "Data": { "CertificadoMatrimonio": { "Folio": "500515253001", "CodigoVerificacion": "c846470891ff", "FechaEmision": "2023-09-28T16:32:00", "DatosRegistro": { "Circunscripcion": "SAN JOSÉ DE MAIPO", "NumeroInscripcion": "9.821", "Registro": "E", "Anio": "1997", "NombreConyuge1": "NOMBRE1 NOMBRE2 APELLIDO1 APELLIDO2", "RunConyuge1": "11.222.333-7", "FechaNacimientoConyuge1": "1980-04-25", "NombreConyuge2": "NOMBRE1 NOMBRE2 APELLIDO1 APELLIDO2", "RunConyuge2": "11.222.333-7", "FechaNacimientoConyuge2": "1980-04-25", "FechaCelebracion": "1980-04-25T11:00:00" }, "NombreArchivo": "MAT_500515253001_11222333.pdf", "Documento": "<document>" } }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }