Frontman API

Dashboard

Resumen general del sistema

Cargando...

Top por consultas

API Keys

Keys manuales para clientes

Crear nueva key

Nombre

Límite diario

Key generada — cópiala ahora

Keys activas

Usuarios

Presiona el lápiz para editar límites, días de acceso y estado

Lista de usuarios

Logs

Últimas consultas realizadas

Actividad reciente

Probar API

Consultas de prueba desde el panel

Consulta

Tipo

Valor

Límite

Mi cuenta

Resumen de tu plan y uso

—

Usuario activo

Activo

Uso diario

0 / 0 consultas0%

—

Total consultas

—

Hoy

—

Límite diario

—

Restantes hoy

Tu API Key

—

Nunca compartas tu key.

Consultar

Busca por DNI o número de celular

Nueva consulta

Tipo

Valor

Límite

Documentación

Guía de integración · Frontman API v3

Autenticación

Todas las peticiones requieren el header x-api-key con tu API Key.

x-api-key: sgapi-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

URL Base

https://frontman.space

Endpoints disponibles

GET /api/dni/{documento}

Busca por DNI en el índice nacional (157M registros)

documento — DNI a consultar (8 dígitos)

?limite=10 — Cantidad de resultados (máx. 1000)

GET /api/numero/{telefono}

Busca por número de teléfono en el índice nacional

telefono — Número a consultar

GET /api/nombre/{nombre}

Busca por nombre completo (máx. 200 resultados)

GET /peru/dni/{documento}

Busca por DNI en base de datos Perú (43M registros · operadoras)

GET /peru/telefono/{telefono}

Busca por teléfono en base Perú

GET /seeker/dni/{documento}

DBSeeker 2024 · 45M registros · búsqueda por DNI

GET /seeker/numero/{numero}

DBSeeker 2024 · búsqueda por número

GET /arg/dni/{documento}

Argentina 94M · búsqueda por DNI

GET /arg/telefono/{telefono}

Argentina 94M · búsqueda por teléfono

GET /arg/nombre/{nombre}

Argentina 94M · búsqueda por nombre

GET /api/me

Retorna información de tu cuenta y uso del día

Ejemplos · cURL

Buscar por DNI

curl -X GET "https://frontman.space/api/dni/12345678?limite=5" \
  -H "x-api-key: sgapi-TU_API_KEY_AQUI"

Buscar por teléfono

curl -X GET "https://frontman.space/api/numero/987654321" \
  -H "x-api-key: sgapi-TU_API_KEY_AQUI"

Ver tu cuenta

curl -X GET "https://frontman.space/api/me" \
  -H "x-api-key: sgapi-TU_API_KEY_AQUI"

Ejemplos · Python

Instalación

pip install requests

Buscar por DNI

import requests

API_KEY = "sgapi-TU_API_KEY_AQUI"
BASE_URL = "https://frontman.space"

headers = {"x-api-key": API_KEY}

# Buscar por DNI
resp = requests.get(
    f"{BASE_URL}/api/dni/12345678",
    headers=headers,
    params={"limite": 5}
)

if resp.status_code == 200:
    resultados = resp.json()
    for r in resultados:
        print(r)
else:
    print("Error:", resp.status_code, resp.json())

Buscar por teléfono · Perú

resp = requests.get(
    f"{BASE_URL}/peru/telefono/987654321",
    headers=headers
)
print(resp.json())

Ejemplos · PHP

Buscar por DNI (cURL)

<?php
$apiKey  = 'sgapi-TU_API_KEY_AQUI';
$baseUrl = 'https://frontman.space';
$dni     = '12345678';

$ch = curl_init("$baseUrl/api/dni/$dni?limite=5");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["x-api-key: $apiKey"],
]);

$response = curl_exec($ch);
$data     = json_decode($response, true);
curl_close($ch);

foreach ($data as $registro) {
    echo $registro['nombre'] . PHP_EOL;
}
?>

Buscar por número (file_get_contents)

<?php
$apiKey  = 'sgapi-TU_API_KEY_AQUI';
$numero  = '987654321';

$opts = ['http' => [
    'method' => 'GET',
    'header' => "x-api-key: $apiKey\r\n",
]];

$url  = "https://frontman.space/api/numero/$numero";
$json = file_get_contents($url, false, stream_context_create($opts));
$data = json_decode($json, true);
print_r($data);
?>

Códigos de respuesta

200OK — Resultados encontrados

401Sin API key en el header

403API key inválida o desactivada

404Sin resultados para esa consulta

429Límite diario alcanzado

500Error interno del servidor

Generación de documentos médicos

Todos los endpoints de documentos médicos reciben JSON por POST y devuelven un archivo PDF binario listo para descargar. El header de respuesta incluye códigos de verificación.

POST/descanso/generar

Constancia de Descanso Médico MINSA — genera PDF oficial

diresa — Dirección Regional de Salud (ej: LIMA)

paciente_nombre, paciente_edad, paciente_dni — datos del paciente

fecha_inicio, fecha_fin — rango del descanso (DD/MM/AAAA)

diagnostico — CIE-10 o descripción del diagnóstico

observaciones — opcional

POST/citt/generar

CITT EsSalud — Certificado de Incapacidad Temporal para el Trabajo

nombre_paciente, dni, contingencia — datos del asegurado

fecha_inicio, fecha_fin — período (DD/MM/AAAA)

total_dias — opcional, se calcula automáticamente

Respuesta incluye header X-CITT con el código generado y X-Verificador con el link QR

POST/minsa/generar

CITT MINSA — Certificado de Incapacidad Temporal para el Trabajo (versión MINSA)

establecimiento, nombre_paciente, dni — datos del paciente

contingencia, tipo_atencion, especialidad — datos médicos

fecha_inicio, fecha_fin, medico_nombre, medico_cmp — período y médico

POST/laluz/generar

Clínica La Luz — Receta y descanso médico con QR verificable

paciente_nombre, dni_paciente, diagnostico — datos del paciente

fecha_inicio, fecha_fin, dias, hora, tipo_descanso — período

medicamentos — array de objetos: nombre, indicaciones, via, dosis, frecuencia, tiempo, cantidad

Respuesta incluye header X-Codigo y X-Verificador

Ejemplos · cURL — Documentos Médicos

Descanso Médico MINSA

curl -X POST "https://frontman.space/descanso/generar" \
  -H "x-api-key: sgapi-TU_API_KEY_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "diresa": "LIMA",
    "paciente_nombre": "JUAN PEREZ GARCIA",
    "paciente_edad": "35",
    "paciente_dni": "12345678",
    "fecha_inicio": "13/05/2026",
    "fecha_fin": "15/05/2026",
    "diagnostico": "J06.9 INFECCION AGUDA DE LAS VIAS RESPIRATORIAS",
    "observaciones": "Reposo absoluto"
  }' \
  --output DESCANSO_12345678.pdf

CITT EsSalud

curl -X POST "https://frontman.space/citt/generar" \
  -H "x-api-key: sgapi-TU_API_KEY_AQUI" \
  -H "Content-Type: application/json" \
  -D headers.txt \
  -d '{
    "nombre_paciente": "MARIA LOPEZ RIOS",
    "dni": "87654321",
    "contingencia": "ENFERMEDAD",
    "fecha_inicio": "13/05/2026",
    "fecha_fin": "17/05/2026"
  }' \
  --output CITT_87654321.pdf
# El código CITT queda en headers.txt (X-CITT) junto al link verificador (X-Verificador)

CITT MINSA

curl -X POST "https://frontman.space/minsa/generar" \
  -H "x-api-key: sgapi-TU_API_KEY_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "establecimiento": "HOSPITAL NACIONAL CAYETANO HEREDIA",
    "nombre_paciente": "CARLOS RUIZ MENDOZA",
    "dni": "45678901",
    "contingencia": "ENFERMEDAD",
    "tipo_atencion": "CONSULTA EXTERNA",
    "especialidad": "MEDICINA GENERAL",
    "fecha_inicio": "13/05/2026",
    "fecha_fin": "15/05/2026",
    "medico_nombre": "GARCIA TORRES PEDRO JOSE",
    "medico_cmp": "012345"
  }' \
  --output MINSA_45678901.pdf

Clínica La Luz (con medicamentos)

curl -X POST "https://frontman.space/laluz/generar" \
  -H "x-api-key: sgapi-TU_API_KEY_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "paciente_nombre": "ANA TORRES VEGA",
    "dni_paciente": "56789012",
    "diagnostico": "INFECCION GASTROINTESTINAL",
    "fecha_inicio": "13/05/2026",
    "fecha_fin": "15/05/2026",
    "dias": 3,
    "hora": "09:00 A.M.",
    "tipo_descanso": "MEDICO DOMICILIARIO",
    "medicamentos": [
      {
        "nombre": "AMOXICILINA 500MG",
        "indicaciones": "1 CAPSULA CADA 8 HRS",
        "via": "ORAL",
        "dosis": "500MG",
        "frecuencia": "8 Horas",
        "tiempo": "7 Dias",
        "cantidad": "21"
      }
    ]
  }' \
  --output LALUZ_56789012.pdf

Ejemplos · Python — Documentos Médicos

Descanso Médico MINSA

import requests

API_KEY  = "sgapi-TU_API_KEY_AQUI"
BASE_URL = "https://frontman.space"
headers  = {"x-api-key": API_KEY, "Content-Type": "application/json"}

resp = requests.post(f"{BASE_URL}/descanso/generar", headers=headers, json={
    "diresa": "LIMA",
    "paciente_nombre": "JUAN PEREZ GARCIA",
    "paciente_edad": "35",
    "paciente_dni": "12345678",
    "fecha_inicio": "13/05/2026",
    "fecha_fin": "15/05/2026",
    "diagnostico": "J06.9 INFECCION AGUDA DE LAS VIAS RESPIRATORIAS",
    "observaciones": "Reposo absoluto"
})

if resp.status_code == 200:
    with open("DESCANSO_12345678.pdf", "wb") as f:
        f.write(resp.content)
    print("PDF guardado correctamente")
else:
    print("Error:", resp.json())

CITT EsSalud (con código de verificación)

resp = requests.post(f"{BASE_URL}/citt/generar", headers=headers, json={
    "nombre_paciente": "MARIA LOPEZ RIOS",
    "dni": "87654321",
    "contingencia": "ENFERMEDAD",
    "fecha_inicio": "13/05/2026",
    "fecha_fin": "17/05/2026"
})

if resp.status_code == 200:
    citt_code  = resp.headers.get("X-CITT")
    verificador = resp.headers.get("X-Verificador")
    print(f"Código CITT: {citt_code}")
    print(f"Link QR:     {verificador}")
    with open(f"CITT_{citt_code}.pdf", "wb") as f:
        f.write(resp.content)

Clínica La Luz (con medicamentos)

resp = requests.post(f"{BASE_URL}/laluz/generar", headers=headers, json={
    "paciente_nombre": "ANA TORRES VEGA",
    "dni_paciente": "56789012",
    "diagnostico": "INFECCION GASTROINTESTINAL",
    "fecha_inicio": "13/05/2026",
    "fecha_fin": "15/05/2026",
    "dias": 3,
    "hora": "09:00 A.M.",
    "tipo_descanso": "MEDICO DOMICILIARIO",
    "medicamentos": [
        {
            "nombre": "AMOXICILINA 500MG",
            "indicaciones": "1 CAPSULA CADA 8 HRS",
            "via": "ORAL",
            "dosis": "500MG",
            "frecuencia": "8 Horas",
            "tiempo": "7 Dias",
            "cantidad": "21"
        }
    ]
})

if resp.status_code == 200:
    codigo = resp.headers.get("X-Codigo")
    with open(f"LALUZ_{codigo}.pdf", "wb") as f:
        f.write(resp.content)
    print(f"PDF guardado: LALUZ_{codigo}.pdf")

Ejemplos · PHP — Documentos Médicos

Descanso Médico MINSA

<?php
$apiKey  = 'sgapi-TU_API_KEY_AQUI';
$payload = json_encode([
    'diresa'          => 'LIMA',
    'paciente_nombre' => 'JUAN PEREZ GARCIA',
    'paciente_edad'   => '35',
    'paciente_dni'    => '12345678',
    'fecha_inicio'    => '13/05/2026',
    'fecha_fin'       => '15/05/2026',
    'diagnostico'     => 'J06.9 INFECCION AGUDA DE LAS VIAS RESPIRATORIAS',
    'observaciones'   => 'Reposo absoluto',
]);

$ch = curl_init('https://frontman.space/descanso/generar');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        "x-api-key: $apiKey",
        'Content-Type: application/json',
    ],
]);

$pdf = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($code === 200) {
    file_put_contents('DESCANSO_12345678.pdf', $pdf);
    echo "PDF guardado\n";
}
?>

CITT EsSalud (capturando código X-CITT)

<?php
$apiKey  = 'sgapi-TU_API_KEY_AQUI';
$payload = json_encode([
    'nombre_paciente' => 'MARIA LOPEZ RIOS',
    'dni'             => '87654321',
    'contingencia'    => 'ENFERMEDAD',
    'fecha_inicio'    => '13/05/2026',
    'fecha_fin'       => '17/05/2026',
]);

$citt = ''; $verificador = '';
$ch = curl_init('https://frontman.space/citt/generar');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => ["x-api-key: $apiKey", 'Content-Type: application/json'],
    CURLOPT_HEADERFUNCTION => function($ch, $header) use (&$citt, &$verificador) {
        if (stripos($header, 'X-CITT:') === 0)
            $citt = trim(explode(':', $header, 2)[1]);
        if (stripos($header, 'X-Verificador:') === 0)
            $verificador = trim(explode(':', $header, 2)[1]);
        return strlen($header);
    },
]);

$pdf = curl_exec($ch);
curl_close($ch);

file_put_contents("CITT_{$citt}.pdf", $pdf);
echo "CITT: $citt\nVerificador: $verificador\n";
?>

Clínica La Luz

<?php
$apiKey  = 'sgapi-TU_API_KEY_AQUI';
$payload = json_encode([
    'paciente_nombre' => 'ANA TORRES VEGA',
    'dni_paciente'    => '56789012',
    'diagnostico'     => 'INFECCION GASTROINTESTINAL',
    'fecha_inicio'    => '13/05/2026',
    'fecha_fin'       => '15/05/2026',
    'dias'            => 3,
    'hora'            => '09:00 A.M.',
    'tipo_descanso'   => 'MEDICO DOMICILIARIO',
    'medicamentos'    => [[
        'nombre'       => 'AMOXICILINA 500MG',
        'indicaciones' => '1 CAPSULA CADA 8 HRS',
        'via'          => 'ORAL',
        'dosis'        => '500MG',
        'frecuencia'   => '8 Horas',
        'tiempo'       => '7 Dias',
        'cantidad'     => '21',
    ]],
]);

$ch = curl_init('https://frontman.space/laluz/generar');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => ["x-api-key: $apiKey", 'Content-Type: application/json'],
]);

$pdf = curl_exec($ch);
curl_close($ch);
file_put_contents('LALUZ_56789012.pdf', $pdf);
echo "PDF generado\n";
?>

Perú

43M registros · MOVISTAR, CLARO, ENTEL, OSIPTEL

Consulta Perú

Tipo

Valor

Límite

Perú

Búsqueda en base de datos Perú

Consulta Perú

Tipo

Valor

Límite

DBSeeker 2024

45M registros · MOVISTAR, ENTEL, CLARO · DNI o número

Consulta DBSeeker

Tipo

Valor

Límite

DBSeeker 2024

45M registros · DNI o número

Consulta DBSeeker

Tipo

Valor

Límite

Atención Perú

2M registros · atención al cliente ENTEL y MOVISTAR

Consulta Atención

Tipo

Valor

Límite

Atención Perú

Búsqueda en base de atención al cliente

Consulta Atención

Tipo

Valor

Límite

Argentina

94 millones de registros · búsqueda por DNI, teléfono o nombre

Consulta Argentina

Tipo

Valor

Límite

Argentina

Búsqueda en base de datos Argentina

Consulta Argentina

Tipo

Valor

Límite

Descanso Médico

Constancia MINSA en PDF

Generar Descanso

DIRESA

Nombre paciente

Edad

DNI

Fecha inicio (DD/MM/AAAA)

Fecha fin (DD/MM/AAAA)

Diagnóstico

Observaciones

Descanso Médico

Constancia MINSA en PDF

Generar Descanso

DIRESA

Nombre paciente

Edad

DNI

Fecha inicio (DD/MM/AAAA)

Fecha fin (DD/MM/AAAA)

Diagnóstico

Observaciones

CITT EsSalud

Certificado de Incapacidad Temporal — CITT generado automáticamente

Generar CITT

Nombre paciente *

DNI *

Contingencia / Diagnóstico *

Fecha inicio * (DD/MM/AAAA)

Fecha fin * (DD/MM/AAAA)

Días de descanso

CITT EsSalud

Certificado de Incapacidad Temporal — CITT generado automáticamente

Generar CITT

Nombre paciente *

DNI *

Contingencia / Diagnóstico *

Fecha inicio * (DD/MM/AAAA)

Fecha fin * (DD/MM/AAAA)

Días de descanso

CITT MINSA

Certificado de Incapacidad Temporal — MINSA

Generar CITT MINSA

Establecimiento *

Nombre paciente *

DNI *

Contingencia / Diagnóstico *

Fecha inicio * (DD/MM/AAAA)

Fecha fin * (DD/MM/AAAA)

Días de descanso

Tipo Atención

Especialidad

CITT MINSA

Certificado de Incapacidad Temporal — MINSA

Generar CITT MINSA

Establecimiento *

Nombre paciente *

DNI *

Contingencia / Diagnóstico *

Fecha inicio * (DD/MM/AAAA)

Fecha fin * (DD/MM/AAAA)

Días de descanso

Tipo Atención

Especialidad

Clínica La Luz

Descanso Médico — Clínica La Luz con verificador QR

Generar Descanso Médico

Nombre paciente *

Provincia

Diagnóstico *

Fecha inicio * (DD/MM/AAAA)

Fecha fin * (DD/MM/AAAA)

Días

Hora

Tipo descanso

DNI Paciente

Medicamentos (máx. 5)

Medicamento 1

Indicaciones

Vía

Dosis

Frecuencia

Tiempo

Cantidad

Medicamento 2

Indicaciones

Vía

Dosis

Frecuencia

Tiempo

Cantidad

Medicamento 3

Indicaciones

Vía

Dosis

Frecuencia

Tiempo

Cantidad

Medicamento 4

Indicaciones

Vía

Dosis

Frecuencia

Tiempo

Cantidad

Medicamento 5

Indicaciones

Vía

Dosis

Frecuencia

Tiempo

Cantidad

Clínica La Luz

Descanso Médico — Clínica La Luz con verificador QR

Generar Descanso Médico

Nombre paciente *

Provincia

Diagnóstico *

Fecha inicio * (DD/MM/AAAA)

Fecha fin * (DD/MM/AAAA)

Días

Hora

Tipo descanso

DNI Paciente

Medicamentos (máx. 5)

Medicamento 1

Indicaciones

Vía

Dosis

Frecuencia

Tiempo

Cantidad

Medicamento 2

Indicaciones

Vía

Dosis

Frecuencia

Tiempo

Cantidad

Medicamento 3

Indicaciones

Vía

Dosis

Frecuencia

Tiempo

Cantidad

Medicamento 4

Indicaciones

Vía

Dosis

Frecuencia

Tiempo

Cantidad

Medicamento 5

Indicaciones

Vía

Dosis

Frecuencia

Tiempo

Cantidad