Skip to main content

​
Overview

The Personal Data Capture API allows you to collect and manage comprehensive personal information for candidates undergoing background evaluations in the vLife DGO system. This includes demographic data, contact information, residential address, and social media profiles.

​
Authentication

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

​
Get Personal Data

Retrieves existing personal data 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:
​
dataPerma
object
Complete personal data record for the candidate
​
GetRedesSociales
array
Array of social media accounts associated with the candidate
​
dataRFCandCURP
object
RFC (Tax ID) and CURP (National ID) information

​
Save Personal Data

Saves new personal data for a candidate in the permanencia (current employee) evaluation process.

​
Request Body

​
evalID
string
required
Evaluation ID for the candidate

​
Demographic Information

​
personalesNombre
string
required
Full name of the candidate
​
personalesFechaNac
date
required
Date of birth
​
personalesLugarNac
string
required
Place of birth
​
personalesNacionalidad
string
required
Nationality
​
personalesSexo
string
required
Gender/Sex
​
personalesEdoCivil
string
required
Marital status
​
personalesEdad
integer
required
Age in years
​
personalesEscolaridad
string
required
Educational level

​
Government IDs

​
personalesRFC
string
required
RFC (Registro Federal de Contribuyentes) - Tax ID
​
personalesCURP
string
required
CURP (Clave Única de Registro de Población) - National ID

​
Contact Information

​
personalesTelFijo
string
Landline phone number
​
personalesTelCelular
string
required
Mobile/cell phone number
​
personalesTelOficina
string
Office phone number
​
personalesExt
string
Office phone extension
​
personalesTelRecados
string
Emergency/message phone number
​
personalesPersonaRecados
string
Name of person who takes messages
​
personalesEmail
string
required
Email address

​
Residential Address

​
personalesCalleNum
string
required
Street name and number
​
personalesColonia
string
required
Neighborhood/Colony
​
personalesCP
string
required
Postal code
​
personalesLocalidad
string
required
City/Locality
​
personalesEstado
string
required
State
​
personalesAnioDom
integer
Years living at current address
​
personalesPersonasHab
integer
Number of people living in the household
​
personalesEntreCalles
string
Cross streets (between which streets)
​
personalesFachada
string
Facade/building description
​
personalesObservaciones
text
Additional observations or notes
​
personalesGoogle
string
Google Maps link or coordinates
​
encryptedData
string
required
Encrypted evaluation data for redirection

​
Response

​
success
string
“Datos personales guardados, captura redes sociales” - Success message prompting to capture social networks

​
Example Request

{
  "evalID": "12345",
  "personalesNombre": "Juan Pérez García",
  "personalesFechaNac": "1985-03-15",
  "personalesLugarNac": "Durango, Durango",
  "personalesNacionalidad": "Mexicana",
  "personalesSexo": "M",
  "personalesEdoCivil": "Casado",
  "personalesEdad": 39,
  "personalesEscolaridad": "Licenciatura",
  "personalesRFC": "PEGJ850315ABC",
  "personalesCURP": "PEGJ850315HDFRNN09",
  "personalesTelCelular": "6181234567",
  "personalesEmail": "[email protected]",
  "personalesCalleNum": "Av. 20 de Noviembre 123",
  "personalesColonia": "Centro",
  "personalesCP": "34000",
  "personalesLocalidad": "Durango",
  "personalesEstado": "Durango",
  "personalesAnioDom": 5,
  "personalesPersonasHab": 4,
  "personalesGoogle": "https://maps.google.com/?q=24.027,-104.653"
}

​
Update Personal Data

Updates existing personal data for a candidate.

​
Request Body

​
personalesID
string
required
ID of the personal data record to update
All other fields are the same as in the Save endpoint (except evalID is not required).

​
Response

​
success
string
“Datos personales actualizados” - Personal data updated successfully

​
Save Social Network

Adds a social media account to the candidate’s profile.

​
Request Body

​
evalID
string
required
Evaluation ID for the candidate
​
redesTipoRed
string
required
Type of social network (e.g., “Facebook”, “Twitter”, “Instagram”, “LinkedIn”)
​
redesUsuario
string
required
Username or profile URL on the social network

​
Response

​
success
string
“Red social guardada” - Social network saved successfully

​
Example Request

{
  "evalID": "12345",
  "redesTipoRed": "Facebook",
  "redesUsuario": "juan.perez.oficial"
}

​
Delete Social Network

Removes a social media account from the candidate’s profile.

​
Request Body

​
redesID
string
required
ID of the social network record to delete

​
Response

​
success
string
“Red social borrada” - Social network deleted successfully

​
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.

​
Notes

  • All POST endpoints redirect back to the previous page after completion
  • Flash messages are used to communicate success or error states
  • Personal data must be saved before social networks can be added
  • The encrypted data parameter ensures data security during transmission

Build docs developers (and LLMs) love

Get started for freeTalk to us