REST API Endpoints for Applicant Data Lookup

The applicant endpoints let you retrieve detailed information about university admission candidates — from full admitted-student records linked to biometric codes, to lightweight score lookups and CEPRE enrollment checks. Most lookup endpoints accept a national ID number (DNI) as a path parameter.

GET /api/get-ingresante///

Returns the full admitted student record for a given DNI, year, and admission cycle. This endpoint joins across postulante, inscripciones, resultados, programa, facultad, procesos, filial, tipo_proceso, paises, and control_biometrico to produce a comprehensive snapshot of the admitted student. Authentication: Sanctum Bearer token required.

Path Parameters

dni

string

required

The applicant’s national identity document number (8 digits for DNI).

anio

integer

required

The admission year (e.g., 2024).

ciclo

integer

required

The admission cycle number within the year (e.g., 1 for the first cycle, 2 for the second).

Example Request

curl https://your-domain.com/api/get-ingresante/12345678/2024/1 \
  -H "Authorization: Bearer {token}"

Response — HTTP 200 (found)

{
  "status": true,
  "mensaje": "-",
  "data": {
    "nombres": "JUAN",
    "primer_apellido": "QUISPE",
    "segundo_apellido": "MAMANI",
    "tipo_documento": "DNI",
    "nro_documento": "12345678",
    "sexo": "M",
    "estado_civil": "S",
    "celular": "987654321",
    "fecha_nacimiento": "2000-05-15",
    "email": "juan@ejemplo.com",
    "ubigeo_residencia": "210101",
    "ubigeo_nacimiento": "210101",
    "direccion": "AV. UNIVERSITARIA 123",
    "discapacidad": null,
    "pais_nacimiento": "PE",
    "nacionalidad": "PERUANA",
    "codigo_ingreso": "240110001",
    "codigo_sede_filial": "JULIACA",
    "tipo_proceso": 1,
    "proceso_admision": "2024-1",
    "codigo_facultad": "FAC-ING",
    "codigo_programa": "080301"
  }
}

Response — HTTP 203 (not found)

{
  "status": false,
  "mensaje": "Ingresante no encontrado"
}

GET /api/get-ingresante-pago///

Returns a lightweight admitted student record used for payment-related lookups. This endpoint is public and requires no authentication. Unlike GET /api/get-ingresante, it does not filter by year and cycle at query time (the parameters are accepted but currently unused in the query); it returns the first matching record for the given DNI. Authentication: None.

Path Parameters

dni

string

required

The applicant’s DNI.

anio

integer

required

The admission year (e.g., 2024). Accepted as a path segment; reserved for future filtering.

ciclo

integer

required

The admission cycle number. Accepted as a path segment; reserved for future filtering.

Example Request

curl https://your-domain.com/api/get-ingresante-pago/12345678/2024/1

Response — HTTP 200 (found)

{
  "status": true,
  "mensaje": "Ingresante encontrado",
  "data": {
    "nombres": "JUAN",
    "primer_apellido": "QUISPE",
    "segundo_apellido": "MAMANI",
    "nro_documento": "12345678",
    "codigo_ingreso": "240110001",
    "id_programa": 5
  }
}

Response — HTTP 203 (not found)

{
  "status": false,
  "mensaje": "Ingresante no encontrado"
}

GET /api/get-postulante-pago//

Returns a base applicant record for payment verification purposes, keyed by DNI and process ID. Authentication: Sanctum Bearer token required.

Path Parameters

dni

string

required

The applicant’s DNI.

proceso

integer

required

The internal admission process ID.

Example Request

curl https://your-domain.com/api/get-postulante-pago/12345678/9 \
  -H "Authorization: Bearer {token}"

Response — HTTP 200

{
  "nro_doc": "12345678",
  "primer_apellido": "QUISPE",
  "segundo_apellido": "MAMANI",
  "nombres": "JUAN",
  "id_gestion": "",
  "id_programa": "",
  "pagos": null
}

GET /api/v1/get-postulante-inscrito/

Returns the list of admission processes that a given applicant is currently enrolled in. The response groups all enrolled processes as a JSON array under user_info.procesos. Authentication: Sanctum Bearer token required.

Path Parameters

dni

string

required

The applicant’s DNI.

Example Request

curl https://your-domain.com/api/v1/get-postulante-inscrito/12345678 \
  -H "Authorization: Bearer {token}"

Response — HTTP 200 (found)

{
  "estado": true,
  "user_info": {
    "dni": "12345678",
    "nombres": "JUAN",
    "paterno": "QUISPE",
    "materno": "MAMANI",
    "procesos": [
      "ADMISIÓN 2024-I JULIACA",
      "ADMISIÓN CEPRE 2024-II"
    ]
  }
}

Response — HTTP 200 (not found)

{
  "estado": false,
  "user_info": null
}

GET /api/get-puntaje/

Returns the applicant’s score records for the current admission year. Results include the programme name, admission modality, total score, vocational score, and apto/no-apto condition. Authentication: None.

Path Parameters

dni

string

required

The applicant’s DNI.

Example Request

curl https://your-domain.com/api/get-puntaje/12345678

Response Fields

datos

array

Array of score records for the applicant.

fecha

string

Date the score was recorded.

dni

string

Applicant DNI.

nombres

string

Applicant first names.

primer_apellido

string

Applicant paternal surname.

segundo_apellido

string

Applicant maternal surname.

modalidad

string

Admission modality code.

puntaje

number

Total score.

puntaje_vocacional

number

Vocational aptitude score.

condicion

string

Admission condition — SI (qualified) or NO.

programa

string

Name of the academic programme from the programa table.

Example Response

{
  "datos": [
    {
      "fecha": "2024-03-15",
      "dni": "12345678",
      "nombres": "JUAN",
      "primer_apellido": "QUISPE",
      "segundo_apellido": "MAMANI",
      "modalidad": "ORD",
      "puntaje": 68.5,
      "puntaje_vocacional": 14,
      "condicion": "SI",
      "programa": "INGENIERÍA DE SISTEMAS"
    }
  ]
}

GET /api/v1/resultados_simulacro/

Returns the simulacro (mock exam) results for an applicant from the resultados_sim table. Authentication: None.

Path Parameters

dni

string

required

The applicant’s DNI.

Example Request

curl https://your-domain.com/api/v1/resultados_simulacro/12345678

Response Fields

integer

Internal record ID.

dni

string

Applicant DNI.

nombres

string

Applicant full names.

puntaje

number

Simulacro score.

programa

string

Programme the applicant applied to.

fecha

string

Date of the simulacro exam.

created_at

string

Record creation timestamp.

updated_at

string

Record last-updated timestamp.

Example Response

{
  "id": 201,
  "dni": "12345678",
  "nombres": "JUAN QUISPE MAMANI",
  "puntaje": 55.75,
  "programa": "ENFERMERÍA",
  "fecha": "2024-02-10",
  "created_at": "2024-02-11T08:00:00.000000Z",
  "updated_at": "2024-02-11T08:00:00.000000Z"
}

GET /api/v1/get-foto-ingresante/

Returns the admitted student’s most recent photo as a Base64-encoded string. The image is fetched from the internal document storage server and encoded inline in the response. Authentication: None.

Path Parameters

dni

string

required

The applicant’s DNI.

Example Request

curl https://your-domain.com/api/v1/get-foto-ingresante/12345678

Response — HTTP 200 (found)

{
  "estado": true,
  "foto": "data:image/jpeg;base64,/9j/4AAQSkZJRgAB...",
  "periodo": "202401"
}

Response Fields

estado

boolean

true when the image was successfully retrieved.

foto

string

Base64 data URI of the stored photo, prefixed with the MIME type (e.g., data:image/jpeg;base64,...).

periodo

string

Admission period string formed by concatenating anio and ciclo_oti (e.g., "202401").

Error responses

{ "status": false, "mensaje": "Registro no encontrado" }

{ "status": false, "mensaje": "No se pudo acceder a la imagen. Puede que la URL esté mal o el servicio no responda." }

{ "status": false, "mensaje": "El archivo descargado no es una imagen válida." }

GET /api/verificar-ingreso//

Checks whether an applicant has been admitted (ingresante) in a given period. The period is a concatenated string of anio + ciclo_oti (e.g., "202401"). The endpoint also accepts a codigo_ingreso in place of a DNI. Authentication: None.

Path Parameters

periodo

string

required

Admission period string formed by concatenating year and zero-padded cycle, e.g., 202401 for 2024 cycle 1.

dni

string

required

The applicant’s DNI or their codigo_ingreso.

Example Request

curl https://your-domain.com/api/verificar-ingreso/202401/12345678

Response Fields

estado

boolean

Always true — indicates the query executed successfully.

ingreso

boolean

true if the applicant was admitted in the specified period; false otherwise.

codigo

string | null

The admission code (codigo_ingreso) when the applicant is found; null otherwise.

Example Response

{
  "estado": true,
  "ingreso": true,
  "codigo": "240110001"
}

GET /api/biometrico/seguimiento//

Returns full biometric tracking data for an admitted applicant in a given period, including programme, modality, and contact details. Authentication: None.

Path Parameters

periodo

string

required

Period string in YYYY-C format, e.g., 2024-1.

dni

string

required

The applicant’s DNI.

Example Request

curl https://your-domain.com/api/biometrico/seguimiento/2024-1/12345678

Response — HTTP 200

{
  "estado": true,
  "datos": [
    {
      "codigo": "240110001",
      "nro_doc": "12345678",
      "nombres": "JUAN",
      "paterno": "QUISPE",
      "materno": "MAMANI",
      "celular": "987654321",
      "email": "juan@ejemplo.com",
      "programa": "INGENIERÍA DE SISTEMAS",
      "modalidad": "ORDINARIO",
      "procesos": "ADMISIÓN 2024-I JULIACA",
      "Periodo": "2024-1"
    }
  ]
}

POST /api/v1/postulante-cepre-inscrito

Checks whether a given DNI is enrolled in CEPRE (Centro Pre-Universitario). This endpoint is public but rate-limited to 50 requests per minute. Authentication: None (throttle: 50 req/min).

Request Body

dni

string

required

The applicant’s DNI to check for CEPRE enrollment.

Example Request

curl -X POST https://your-domain.com/api/v1/postulante-cepre-inscrito \
  -H "Content-Type: application/json" \
  -d '{"dni": "12345678"}'

Exceeding 50 requests per minute from the same IP will return HTTP 429 Too Many Requests. Implement back-off logic in integrations that may burst-query this endpoint.

GET /api/v1/observados-cepre/

Returns CEPRE observation/sanction data for a given DNI. This endpoint is protected by the cepre middleware. Authentication: cepre middleware.

Path Parameters

dni

string

required

The applicant’s DNI.

Example Request

curl https://your-domain.com/api/v1/observados-cepre/12345678 \
  -H "X-Cepre-Token: your-cepre-key"

REST API

Documentation Index

​GET /api/get-ingresante///

​Path Parameters

​Example Request

​Response — HTTP 200 (found)

​Response — HTTP 203 (not found)

​GET /api/get-ingresante-pago///

​Path Parameters

​Example Request

​Response — HTTP 200 (found)

​Response — HTTP 203 (not found)

​GET /api/get-postulante-pago//

​Path Parameters

​Example Request

​Response — HTTP 200

​GET /api/v1/get-postulante-inscrito/

​Path Parameters

​Example Request

​Response — HTTP 200 (found)

​Response — HTTP 200 (not found)

​GET /api/get-puntaje/

​Path Parameters

​Example Request

​Response Fields

​Example Response

​GET /api/v1/resultados_simulacro/

​Path Parameters

​Example Request

​Response Fields

​Example Response

​GET /api/v1/get-foto-ingresante/

​Path Parameters

​Example Request

​Response — HTTP 200 (found)

​Response Fields

​Error responses

​GET /api/verificar-ingreso//

​Path Parameters

​Example Request

​Response Fields

​Example Response

​GET /api/biometrico/seguimiento//

​Path Parameters

​Example Request

​Response — HTTP 200

​POST /api/v1/postulante-cepre-inscrito

​Request Body

​Example Request

​GET /api/v1/observados-cepre/

​Path Parameters

​Example Request

Build docs developers (and LLMs) love

GET /api/get-ingresante///

Path Parameters

Example Request

Response — HTTP 200 (found)

Response — HTTP 203 (not found)

GET /api/get-ingresante-pago///

Path Parameters

Example Request

Response — HTTP 200 (found)

Response — HTTP 203 (not found)

GET /api/get-postulante-pago//

Path Parameters

Example Request

Response — HTTP 200

GET /api/v1/get-postulante-inscrito/

Path Parameters

Example Request

Response — HTTP 200 (found)

Response — HTTP 200 (not found)

GET /api/get-puntaje/

Path Parameters

Example Request

Response Fields

Example Response

GET /api/v1/resultados_simulacro/

Path Parameters

Example Request

Response Fields

Example Response

GET /api/v1/get-foto-ingresante/

Path Parameters

Example Request

Response — HTTP 200 (found)

Response Fields

Error responses

GET /api/verificar-ingreso//

Path Parameters

Example Request

Response Fields

Example Response

GET /api/biometrico/seguimiento//

Path Parameters

Example Request

Response — HTTP 200

POST /api/v1/postulante-cepre-inscrito

Request Body

Example Request

GET /api/v1/observados-cepre/

Path Parameters

Example Request