Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ariellukezz/admision-web/llms.txt

Use this file to discover all available pages before exploring further.

The processes endpoints expose the catalogue of university admission processes configured in the platform. Use the authenticated POST /api/get-procesos endpoint to retrieve a full paginated list for administrative integrations, the public GET /api/get-procesos endpoint to retrieve a simplified results-page list, or the lightweight GET /api/get-select-procesos endpoint to populate dropdowns and select menus without requiring a token.

​
POST /api/get-procesos

Returns a paginated list of admission processes. Supports optional filtering by nivel (education level) and a free-text term that matches against the process name, campus name, modality name, or year. Authentication: Sanctum Bearer token required.

​
Request Body (optional filters)

​
nivel
integer
Filter by education level. 1 = undergraduate (pregrado); 2 = continuing education (segundas especialidades). Omit to return all levels.
​
term
string
Free-text search term matched against process name, campus (filial) name, modality name, and year.

​
Example Request

curl -X POST https://your-domain.com/api/get-procesos \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"nivel": 1, "term": "2024"}'

​
Response — HTTP 200

The response wraps a Laravel paginator inside the datos key. 
{
  "estado": true,
  "datos": {
    "current_page": 1,
    "data": [
      {
        "id": 12,
        "nombre": "ADMISIÓN 2024-I JULIACA",
        "estado": 1,
        "anio": 2024,
        "url": "admision-2024-i-juliaca",
        "fecha_examen": "2024-03-10",
        "ciclo": 1,
        "slug": "admision-2024-i-juliaca",
        "convocatoria": 1,
        "fec_inicio": "2024-01-15",
        "fec_fin": "2024-03-08",
        "fec_examen": "2024-03-10",
        "observacion": null,
        "id_sede": 9,
        "sede": "JULIACA",
        "nivel": 1,
        "id_tipo": 1,
        "tipo": "EXAMEN GENERAL",
        "codigo_proceso": "ADM24I",
        "fec_1": "2024-03-10",
        "fec_2": null,
        "id_reglamento": 3,
        "id_modalidad": 1,
        "modalidad": "ORDINARIO"
      }
    ],
    "per_page": 50,
    "total": 28
  }
}

​
Response Fields

​
estado
boolean
true when the query executed successfully.
​
datos
object
Laravel paginated result object.
​
data
array
Array of admission process objects.
​
id
integer
Internal process ID.
​
nombre
string
Full display name of the admission process.
​
estado
integer
Process status. 1 = active, 0 = inactive.
​
anio
integer
Academic year.
​
ciclo
integer
Cycle number within the year (1 or 2).
​
slug
string
URL-friendly identifier used in public enrollment forms.
​
fec_inicio
string
Enrollment start date (ISO 8601).
​
fec_fin
string
Enrollment end date (ISO 8601).
​
fecha_examen
string
Exam date (ISO 8601). Also returned as fec_examen.
​
sede
string
Name of the campus (filial) hosting the process.
​
tipo
string
Process type (e.g., EXAMEN GENERAL, CEPRE).
​
modalidad
string
Admission modality name (e.g., ORDINARIO, TRASLADO EXTERNO).
​
nivel
integer
Education level. 1 = pregrado, 2 = segundas especialidades.
​
convocatoria
integer
Sequential call number within the year (nro_convocatoria).
​
codigo_proceso
string
Short process code used in payment and document references.
​
fec_1
string | null
First auxiliary date for the process (e.g., first exam day).
​
fec_2
string | null
Second auxiliary date for the process (e.g., second exam day).
​
id_reglamento
integer | null
ID of the associated regulation document.
​
current_page
integer
Current page number.
​
per_page
integer
Results per page (fixed at 50).
​
total
integer
Total number of processes matching the query.
Results are ordered by procesos.id DESC, so the most recently created process appears first. Use term to narrow results when integrating with search inputs.

​
GET /api/get-procesos

Returns a simplified list of all undergraduate (nivel = 1) admission processes for use on public results pages. This endpoint requires no authentication and is distinct from the authenticated POST /api/get-procesos endpoint above. Authentication: None.

​
Example Request

curl https://your-domain.com/api/get-procesos

​
Response — HTTP 200

{
  "estado": true,
  "res": [
    {
      "id": 12,
      "nombre": "ADMISIÓN 2024-I JULIACA",
      "slug": "admision-2024-i-juliaca",
      "anio": 2024,
      "estado": 1,
      "fec_fin": "2024-03-08",
      "id_sede_filial": 9,
      "fecha_examen": "2024-03-10",
      "url": "https://your-domain.com/reglamentos/reglamento-2024-i.pdf",
      "fec_1": "2024-03-10",
      "fec_2": null
    }
  ]
}

​
Response Fields

​
estado
boolean
true when the query executed successfully.
​
res
array
Array of admission process objects ordered by id DESC. Only processes with nivel = 1 (undergraduate) are included.
​
id
integer
Internal process ID.
​
nombre
string
Full display name of the admission process.
​
slug
string
URL-friendly identifier.
​
anio
integer
Academic year.
​
estado
integer
Process status. 1 = active, 0 = inactive.
​
fec_fin
string | null
Enrollment end date (ISO 8601).
​
id_sede_filial
integer
ID of the campus (filial) hosting the process.
​
fecha_examen
string | null
Exam date (ISO 8601).
​
url
string | null
Public URL of the linked regulation document (from the joined reglamento table).
​
fec_1
string | null
First auxiliary date for the process.
​
fec_2
string | null
Second auxiliary date for the process.

​
GET /api/get-select-procesos

Returns a lightweight list of active admission processes formatted for use in select/dropdown UI components. Each object contains value (the process ID), label (display name), anio, and a human-readable ciclo label. Authentication: None.

​
Example Request

curl https://your-domain.com/api/get-select-procesos

​
Response — HTTP 200

{
  "estado": true,
  "datos": [
    {
      "value": 12,
      "label": "ADMISIÓN 2024-I JULIACA",
      "anio": 2024,
      "ciclo": "I"
    },
    {
      "value": 13,
      "label": "ADMISIÓN 2024-II JULIACA",
      "anio": 2024,
      "ciclo": "II"
    }
  ]
}

​
Response Fields

​
datos
array
Array of active process option objects. Only processes with estado = 1 are included.
​
value
integer
Process ID to be used as the select option value.
​
label
string
Human-readable process name for display.
​
anio
integer
Academic year of the process.
​
ciclo
string
Cycle label — "I" for cycle 1, "II" for cycle 2.
This endpoint is ideal for populating biometric station dropdowns and public-facing enrollment forms, because it requires no authentication and returns only the minimal fields needed for a select component.

Build docs developers (and LLMs) love

Get started for freeTalk to us