Documentación API

Integra consultas RUC, DNI y Créditos en tus aplicaciones con nuestra API.

Notas Importantes

Autenticación requerida

Todas las peticiones requieren Bearer Token válido

Formato JSON

Content-Type debe ser application/json

Token de Acceso Gratuito

Obtén tu token de acceso gratuito aquí:

https://api-codart.cgrt.org
NORMAL

Consultas con consumo de peticiones

Estas consultas no consumen Créditos. Cada consulta cuenta como 1 petición y tu cuota se renueva automáticamente cada mes, siempre que tu plan siga activo.
Consulta RUC - 1 Peticiones

Endpoint

GET
https://api-codart.cgrt.org/api/v1/consultas/sunat/ruc/ruc

Headers

Nombre Valor
Content-Type application/json
Authorization Bearer <token>

Parámetros

Parámetro Tipo
ruc string (11 dígitos)
- -

Response

Ejemplo de respuesta
{ "success": true, "source": "CODART_X_API_V1", "result": { "razon_social": "ARTROSCOPICTRAUMA S.A.C.", "tipo_documento": "6", "numero_documento": "20538856674", "estado": "ACTIVO", "condicion": "HABIDO", "direccion": "AV. GRAL.GARZON NRO 2320 URB. FUNDO OYAGUE", "ubigeo": "150113", "via_tipo": "AV.", "via_nombre": "GRAL.GARZON", "zona_codigo": "URB.", "zona_tipo": "FUNDO OYAGUE", "numero": "2320", "interior": "-", "lote": "-", "dpto": "-", "manzana": "-", "kilometro": "-", "distrito": "JESUS MARIA", "provincia": "LIMA", "departamento": "LIMA", "es_agente_retencion": false, "es_buen_contribuyente": true, "locales_anexos": null, "tipo": "SOCIEDAD ANONIMA CERRADA", "actividad_economica": "OTRAS ACTIVIDADES DE ATENCION DE LA SALUD HUMANA", "numero_trabajadores": "1", "tipo_facturacion": "MANUAL", "tipo_contabilidad": "MANUAL", "comercio_exterior": "SIN ACTIVIDAD" } }
Consulta DNI - 1 Peticiones

Endpoint

GET
https://api-codart.cgrt.org/api/v1/consultas/reniec/dni/dni

Headers

Nombre Valor
Content-Type application/json
Authorization Bearer <token>

Parámetros

Parámetro Tipo
dni string (8 dígitos)
- -

Response

Ejemplo de respuesta
{ "success": true, "source": "CODART_X_API_V1", "result": { "first_name": "NOMBRE EJEMPLO", "first_last_name": "APELLIDO1", "second_last_name": "APELLIDO2", "full_name": "APELLIDO1 APELLIDO2 NOMBRE EJEMPLO", "document_type": "1", "document_number": "00000000", "birth_date": "Data in credit", "gender": "F", "nationality": "PER", "address": "Data in credit", "district": "Data in credit", "province": "Data in credit", "department": "Data in credit", "phone": "Data in credit", "email": "Data in credit" } }
FD - CREDITS

Consultas con consumo de crédito

Estas consultas consumen Créditos según el tipo de búsqueda. Cada endpoint indica cuántos Créditos descuenta por consulta (por ejemplo: 2, 4 o más Créditos).
Consulta DNI - 2 Créditos

Endpoint

GET
https://api-codart.cgrt.org/api/v1/consultas/fd/dni/dni

Headers

Nombre Valor
Content-Type application/json
Authorization Bearer <token>

Parámetros

Parámetro Tipo
dni string (8 dígitos)
- -

Response

Ejemplo de respuesta
{ "success": true, "source": "CODART_X_API_V1", "data": { "images": [ { "data_uri": "data:image/jpeg;base64,<BASE64_IMAGE_DATA>" } ], "dni": { "numero": "00000000", "digito_verificador": "0", "completo": "00000000 - 0" }, "nombres": "NOMBRE EJEMPLO", "apellidos": "APELLIDO EJEMPLO", "genero": "FEMENINO", "nacimiento": { "fecha": "01/01/2000", "edad": "25 AÑOS", "departamento": "LIMA", "provincia": "LIMA", "distrito": "MIRAFLORES" }, "informacion_general": { "nivel_educativo": "SUPERIOR COMPLETA", "estado_civil": "SOLTERO", "estatura": "1.70 MT.", "fecha_inscripcion": "01/01/2015", "fecha_emision": "01/01/2024", "fecha_caducidad": "01/01/2030", "donante_organos": "NO", "padre": "NOMBRE PADRE", "madre": "NOMBRE MADRE", "restriccion": "NINGUNA" }, "domicilio": { "departamento": "LIMA", "provincia": "LIMA", "distrito": "MIRAFLORES", "direccion": "AV. EJEMPLO 123" }, "ubigeos": { "reniec": "000000", "ine": "00000", "sunat": "00000" } } }
Consulta DNIT - 5 Créditos

Endpoint

GET
https://api-codart.cgrt.org/api/v1/consultas/fd/dnit/dni

Headers

Nombre Valor
Content-Type application/json
Authorization Bearer <token>

Parámetros

Parámetro Tipo
dni string (8 dígitos)
- -

Response

Ejemplo de respuesta
{ "success": true, "source": "CODART_X_API_V1", "data": { "images": [ { "data_uri": "data:image/jpeg;base64,<BASE64_IMAGE_1>" }, { "data_uri": "data:image/jpeg;base64,<BASE64_IMAGE_2>" }, { "data_uri": "data:image/jpeg;base64,<BASE64_IMAGE_3>" }, { "data_uri": "data:image/jpeg;base64,<BASE64_IMAGE_4>" } ], "dni": { "numero": "00000000", "digito_verificador": "0", "completo": "00000000 - 0" }, "nombres": "NOMBRE EJEMPLO", "apellidos": "APELLIDO EJEMPLO", "genero": "FEMENINO", "nacimiento": { "fecha": "01/01/2000", "edad": "25 AÑOS", "departamento": "LIMA", "provincia": "LIMA", "distrito": "MIRAFLORES" }, "informacion_general": { "nivel_educativo": "SUPERIOR COMPLETA", "estado_civil": "SOLTERO", "estatura": "1.70 MT.", "fecha_inscripcion": "01/01/2015", "fecha_emision": "01/01/2024", "fecha_caducidad": "01/01/2030", "donante_organos": "NO", "padre": "NOMBRE PADRE", "madre": "NOMBRE MADRE", "restriccion": "NINGUNA" }, "domicilio": { "departamento": "LIMA", "provincia": "LIMA", "distrito": "MIRAFLORES", "direccion": "AV. EJEMPLO 123" }, "ubigeos": { "reniec": "000000", "ine": "00000", "sunat": "000000" } } }
Consulta NM - 4 Créditos

Endpoint

GET
https://api-codart.cgrt.org/api/v1/consultas/fd/nm?n1=n1&ap1=ap1&ap2=ap2

Headers

Nombre Valor
Content-Type application/json
Authorization Bearer <token>

Parámetros

Parámetro Tipo
n1, ap1, ap2 string (al menos 2 segmentos con letras)
- -

Response

Ejemplo de respuesta
{ "success": true, "source": "CODART_X_API_V1", "data": { "cantidad_resultados": 2, "resultados": [ { "dni": "00000001", "nombres": "NOMBRE EJEMPLO 1", "apellidos": "APELLIDO EJEMPLO 1", "edad": 43 }, { "dni": "00000001", "nombres": "NOMBRE EJEMPLO 1", "apellidos": "APELLIDO EJEMPLO 1", "edad": 31 } ] } }
Consulta AG - 8 Créditos

Endpoint

GET
https://api-codart.cgrt.org/api/v1/consultas/fd/ag/dni

Headers

Nombre Valor
Content-Type application/json
Authorization Bearer <token>

Parámetros

Parámetro Tipo
dni string (8 dígitos)
- -

Response

Ejemplo de respuesta
{ "success": true, "source": "CODART_X_API_V1", "data": { "consulta": "00000000", "familiares": 6, "relaciones": [ { "dni": "00000001", "edad": 45, "nombres": "NOMBRE EJEMPLO 1", "apellidos": "APELLIDO EJEMPLO 1", "sexo": "MASCULINO", "relacion": "PADRE", "verificacion": "ALTO" }, { "dni": "00000002", "edad": 42, "nombres": "NOMBRE EJEMPLO 2", "apellidos": "APELLIDO EJEMPLO 2", "sexo": "FEMENINO", "relacion": "MADRE", "verificacion": "ALTO" }, { "dni": "00000003", "edad": 20, "nombres": "NOMBRE EJEMPLO 3", "apellidos": "APELLIDO EJEMPLO 3", "sexo": "FEMENINO", "relacion": "PRIMA MATERNO", "verificacion": "MEDIO" }, { "dni": "00000004", "edad": 18, "nombres": "NOMBRE EJEMPLO 4", "apellidos": "APELLIDO EJEMPLO 4", "sexo": "MASCULINO", "relacion": "PRIMO PATERNO", "verificacion": "ALTO" }, { "dni": "00000005", "edad": 35, "nombres": "NOMBRE EJEMPLO 5", "apellidos": "APELLIDO EJEMPLO 5", "sexo": "MASCULINO", "relacion": "TIO MATERNO", "verificacion": "ALTO" }, { "dni": "00000006", "edad": 16, "nombres": "NOMBRE EJEMPLO 6", "apellidos": "APELLIDO EJEMPLO 6", "sexo": "FEMENINO", "relacion": "HERMANASTRO", "verificacion": "MEDIO" } ] } }
Consulta TELP - 15 Créditos

Endpoint

GET
https://api-codart.cgrt.org/api/v1/consultas/fd/telp/dni

Headers

Nombre Valor
Content-Type application/json
Authorization Bearer <token>

Parámetros

Parámetro Tipo
numero string (8 dígitos)
- -

Response

Ejemplo de respuesta
{ "success": true, "source": "CODART_X_API_V1", "data": { "lineas_encontradas": 5, "lineas": [ { "telefono": "900000001", "operador": "CLARO", "periodo": "202605", "empresa": "AMERICA MOVIL PERU S.A.C." }, { "telefono": "900000002", "operador": "MOVISTAR", "periodo": "202307", "empresa": "TELEFONICA DEL PERU S.A.A." }, { "telefono": "900000003", "operador": "ENTEL", "periodo": "202210", "empresa": "ENTEL PERU S.A." }, { "telefono": "900000004", "operador": "BITEL", "periodo": "202111", "empresa": "VIETTEL PERU S.A.C." } ] } }
Consulta TELP CEL - 15 Créditos

Endpoint

GET
https://api-codart.cgrt.org/api/v1/consultas/fd/telp/cel/numero

Headers

Nombre Valor
Content-Type application/json
Authorization Bearer <token>

Parámetros

Parámetro Tipo
numero string (9 dígitos)
- -

Response

Ejemplo de respuesta
{ "success": true, "source": "CODART_X_API_V1", "data": { "titulares_encontrados": 1, "titulares": [ { "titular": "USUARIO EJEMPLO", "operador": "CLARO", "telefono": "900000001", "dni_ruc": "00000000", "periodo": null, "plan": "PlanDemo69_90", "n_ip": null, "correo": "usuario.demo@example.com", "empresa": "AMERICA MOVIL PERU S.A.C." } ] } }
Consulta PLA - 2 Créditos

Endpoint

GET
https://api-codart.cgrt.org/api/v1/consultas/fd/pla/placa

Headers

Nombre Valor
Content-Type application/json
Authorization Bearer <token>

Parámetros

Parámetro Tipo
placa string (6 o 7 caracteres alfanuméricos)
- -

Response

Ejemplo de respuesta
{ "success": true, "source": "CODART_X_API_V1", "data": { "placa": "D5G960", "images": [ { "data_uri": "data:image/jpeg;base64,<BASE64_IMAGE_DATA>" } ] } }

¿Necesitas ayuda con la integración de la API?

Nuestro equipo de soporte está disponible para resolver tus dudas o brindarte asistencia técnica. Contáctanos a través de los siguientes medios:

Soporte Técnico WhatsApp