Skip to main content

​
Overview

The Academic Data Capture API manages educational credentials and professional training records. This includes formal academic degrees and additional training courses (capacitaciones). Each candidate can have multiple academic degrees and training certifications.

​
Authentication

All endpoints require authentication via the isLoggedIn middleware. Users must have an active session to access these endpoints.

​
Get Academic Data

Retrieves academic history and training records for a specific evaluation.

​
Path Parameters

​
encryptedData
string
required
Encrypted evaluation ID that uniquely identifies the candidate’s evaluation record

​
Response

Returns a view with the following data:
​
dataGradoAcademico
object
The candidate’s highest academic degree record
​
GetCapacitacion
array
Array of training/certification records (capacitaciones)

​
Save Academic Degree

Saves the candidate’s highest academic degree information.

​
Request Body

​
evalID
string
required
Evaluation ID for the candidate
​
academicoUltimoGrado
string
required
Highest academic degree obtained (e.g., “Secundaria”, “Preparatoria”, “Licenciatura”, “Maestría”, “Doctorado”)
​
academicoPeriodoInicio
date
required
Start date of the academic program
​
academicoPeriodoFinal
date
required
End date or graduation date
​
academicoInstitucion
string
required
Name of the educational institution
​
academicoDocumento
string
required
Type of credential or document (e.g., “Título”, “Cédula Profesional”, “Certificado”)
​
academicoUbicacion
string
required
Location of the educational institution (city, state)

​
Response

​
success
string
“Último grado académico guardado” - Academic degree saved successfully

​
Example Request

{
  "evalID": "12345",
  "academicoUltimoGrado": "Licenciatura en Criminología",
  "academicoPeriodoInicio": "2010-08-15",
  "academicoPeriodoFinal": "2014-06-30",
  "academicoInstitucion": "Universidad Juárez del Estado de Durango",
  "academicoDocumento": "Cédula Profesional",
  "academicoUbicacion": "Durango, Durango"
}

​
Update Academic Degree

Updates existing academic degree information.

​
Request Body

​
academicoID
string
required
ID of the academic record to update
​
academicoUltimoGrado
string
required
Highest academic degree
​
academicoPeriodoInicio
date
required
Start date of the program
​
academicoPeriodoFinal
date
required
End date or graduation date
​
academicoInstitucion
string
required
Educational institution name
​
academicoDocumento
string
required
Type of credential
​
academicoUbicacion
string
required
Institution location

​
Response

​
success
string
“Se actualizo grado academico” - Academic degree updated successfully

​
Delete Academic Degree

Deletes an academic degree record.

​
Request Body

​
academicoID
string
required
ID of the academic record to delete

​
Response

​
success
string
“Se eliminó grado academico” - Academic degree deleted successfully

​
Save Training Certification

Adds a professional training course or certification.

​
Request Body

​
evalID
string
required
Evaluation ID for the candidate
​
capacitacionDetalle
string
required
Detailed description of the training course or certification
​
capacitacionInicio
date
required
Start date of the training
​
capacitacionFinal
date
required
End date or completion date
​
capacitacionInstitucion
string
required
Name of the training institution or organization
​
capacitacionDocumento
string
required
Type of certification or document received (e.g., “Diploma”, “Constancia”, “Certificado”)

​
Response

​
success
string
“Capacitación guardada !” - Training certification saved successfully

​
Example Request

{
  "evalID": "12345",
  "capacitacionDetalle": "Curso de Investigación Criminal",
  "capacitacionInicio": "2020-02-01",
  "capacitacionFinal": "2020-03-15",
  "capacitacionInstitucion": "Centro Nacional de Capacitación",
  "capacitacionDocumento": "Constancia"
}

​
Edit Training Certification

Updates an existing training certification record.

​
Request Body

​
capacitacionID
string
required
ID of the training record to update
​
capacitacionDetalle
string
required
Detailed description of the training
​
capacitacionInicio
date
required
Start date
​
capacitacionFinal
date
required
End date
​
capacitacionInstitucion
string
required
Training institution name
​
capacitacionDocumento
string
required
Type of certification received

​
Response

​
success
string
“Se actualizó capacitación” - Training certification updated successfully

​
Delete Training Certification

Removes a training certification record.

​
Request Body

​
capacitacionID
string
required
ID of the training record to delete

​
Response

​
success
string
“Se eliminó capacitación” - Training certification deleted successfully

​
Example Request

{
  "capacitacionID": "78901"
}

​
Error Responses

All endpoints return the following error response on failure:
​
message
string
“Algo salio mal !” - Generic error message indicating something went wrong
The endpoint will redirect back to the previous page with the error message displayed as a flash message.

​
Common Academic Degrees

  • Primaria - Elementary school
  • Secundaria - Middle school
  • Preparatoria/Bachillerato - High school
  • Técnico - Technical degree
  • Licenciatura - Bachelor’s degree
  • Maestría - Master’s degree
  • Doctorado - Doctorate/PhD

​
Common Credential Types

  • Certificado - Certificate
  • Título - Degree title
  • Cédula Profesional - Professional license
  • Diploma - Diploma
  • Constancia - Proof of completion

​
Workflow

  1. Retrieve existing academic data using the GET endpoint
  2. Save the highest academic degree achieved
  3. Add all relevant training certifications using the capacitaciones endpoints
  4. Update or delete records as needed

​
Best Practices

  • Always save the highest academic degree first before adding training certifications
  • Include all relevant professional development courses and certifications
  • Ensure dates are accurate and in chronological order
  • Keep credential documents on file for verification
  • List training courses in reverse chronological order (most recent first)

Build docs developers (and LLMs) love

Get started for freeTalk to us