# Enumere los empleos actuales.

{% admonition type="success" name="¡Próximamente!" %}
  Este recurso está actualmente en desarrollo y, como tal, ciertos nombres de campos o valores pueden cambiar.
{% /admonition %}

## ▶️ Uso

Con el método List Current Employments, puedes:

1. Listar los empleos actuales relacionados con un  específico (usando el parámetro de consulta ).
2. Obtener los detalles de un  específico (usando el parámetro de consulta ).
3.  Listar todos los empleos actuales relacionados con tu cuenta de Belvo (sin usar ningún parámetro de consulta).

## 📖 Paginación

Este método devuelve una respuesta paginada (por defecto: 100 elementos por página). Puedes usar el parámetro de consulta  para aumentar el número de elementos devueltos hasta un máximo de 1000 elementos. Puedes usar el parámetro de consulta  para navegar a través de los resultados. Para más detalles sobre cómo navegar por las respuestas paginadas de Belvo, consulta nuestro artículo Consejos de Paginación.

## 🔦 Filtrado de Respuestas

Consulta la lista de campos a continuación para ver una lista de campos por los que puedes filtrar tus respuestas. Para más información sobre cómo usar filtros, consulta nuestro artículo Filtrando respuestas.

Endpoint: GET /api/mx/current-employments/
Version: 1.223.0
Security: basicAuth

## Query parameters:

  - `id` (string)
    Devuelve información solo para este recurso .
    Example: "24ccab1d-3a86-4136-a6eb-e04bf52b356f"

  - `id__in` (array)
    Devuelve información para estos s de recursos.
    Example: ["6b3dea0f-be29-49d1-aabe-1a6d588642e6"]

  - `link` (string)
    El  por el que deseas filtrar.

ℹ️ Recomendamos encarecidamente añadir el filtro  para mejorar tu rendimiento.
    Example: "8848bd0c-9c7e-4f53-a732-ec896b11d4c4"

  - `link__in` (array)
    Devuelve resultados solo para estos s.
    Example: ["5722d0ba-69d7-42dc-8ff5-33767b83c5d6"]

  - `page_size` (integer)
    Indica cuántos resultados devolver por página. Por defecto, devolvemos 100 resultados por página.

ℹ️ El número mínimo de resultados devueltos por página es 1 y el máximo es 1000. Si introduces un valor mayor que 1000, nuestra API usará por defecto el valor máximo (1000).
    Example: 100

  - `page` (integer)
    Un número de página dentro del conjunto de resultados paginados.
    Example: 1

  - `collected_at` (string)
    Devuelve los elementos que fueron recuperados de la institución en esta fecha ( o marca de tiempo completa ).
    Example: "2022-05-01"

  - `collected_at__gt` (string)
    Devuelve los elementos que fueron recuperados de la institución después de esta fecha ( o marca de tiempo completa en formato ).
    Example: "2022-05-05"

  - `collected_at__gte` (string)
    Devolver los elementos que fueron recuperados de la institución en o después de esta fecha ( o marca de tiempo completa ).
    Example: "2022-05-04"

  - `collected_at__lt` (string)
    Devolver los elementos que fueron recuperados de la institución antes de esta fecha ( o marca de tiempo completa ).
    Example: "2022-04-01"

  - `collected_at__lte` (string)
    Devuelve los elementos que fueron recuperados de la institución en o antes de esta fecha ( o marca de tiempo completa ).
    Example: "2022-03-30"

  - `collected_at__range` (array)
    Devolver los elementos que fueron recuperados de la institución entre dos fechas ( o una marca de tiempo completa en formato ).
    Example: ["2022-05-04"]

  - `created_at` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo en esta fecha (en formato ).
    Example: "2022-05-05"

  - `created_at__gt` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo después de esta fecha (en formato ).
    Example: "2022-05-05"

  - `created_at__gte` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo después o en esta fecha (en formato ).
    Example: "2022-05-04"

  - `created_at__lt` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo antes de esta fecha (en formato ).
    Example: "2022-04-01"

  - `created_at__lte` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo antes o en esta fecha (en formato ).
    Example: "2022-03-30"

  - `created_at__range` (array)
    Devolver cuentas que fueron actualizadas por última vez en la base de datos de Belvo entre dos fechas (en formato ).
    Example: ["2022-03-03"]

## Response 200 fields (application/json):

  - `count` (integer)
    El número total de resultados en tu cuenta de Belvo.
    Example: 130

  - `next` (string,null)
    La URL a la siguiente página de resultados. Cada página consta de hasta 100 elementos. Si no hay suficientes resultados para una página adicional, el valor es .

En nuestro ejemplo de documentación, usamos  como un valor de marcador de posición. En producción, este valor será reemplazado por el endpoint real que estás utilizando actualmente (por ejemplo,  o ).
    Example: "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908page=2"

  - `previous` (string,null)
    La URL a la página anterior de resultados. Si no hay una página anterior, el valor es .

  - `results` (array)

  - `results.id` (string, required)
    Identificador único de Belvo para el elemento actual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `results.link` (string,null, required)
    El  al que pertenecen los datos.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `results.created_at` (string, required)
    La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.collected_at` (string, required)
    La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.month` (string,null, required)
    El mes para el cual se informa el estado de empleo actual, en formato . Si  es , este campo es .
    Example: "2023-01"

  - `results.internal_identification` (string,null, required)
    ID único para el usuario según la institución. Para IMSS e ISSSTE México, esto es el CURP. Si  es , este campo es .
    Example: "BLPM230130IONVGR54"

  - `results.personal_data` (object, required)
    Detalles sobre la información personal del individuo.

  - `results.personal_data.official_name` (string,null, required)
    El nombre legal del individuo.
    Example: "Bruce Banner del Torro"

  - `results.personal_data.first_name` (string,null, required)
    El primer nombre del individuo.
    Example: "Bruce"

  - `results.personal_data.last_name` (string,null, required)
    El apellido del individuo.
    Example: "Banner del Torro"

  - `results.personal_data.birth_date` (string,null, required)
    La fecha de nacimiento del individuo, en formato .
    Example: "1990-02-09"

  - `results.personal_data.document_ids` (array, required)
    Detalles sobre los documentos de identificación del individuo.

  - `results.personal_data.document_ids.document_type` (string,null, required)
    El tipo de documento relacionado con el individuo. Devolvemos uno de los siguientes valores:

  - 
  - 
  -
    Enum: "NSS", "CURP", "RFC"

  - `results.personal_data.document_ids.document_number` (string,null, required)
    El número del documento de identificación (como una cadena).
    Example: "10277663582"

  - `results.status` (string, required)
    El estado actual de empleo del individuo.
    Enum: "EMPLOYED", "UNEMPLOYED"

  - `results.current_employment_records` (array,null, required)
    Detalles sobre el empleo actual del individuo. Si  es , este campo es .

  - `results.current_employment_records.employer` (string, required)
    El nombre oficial del empleador.
    Example: "Batman Enterprises CDMX"

  - `results.current_employment_records.employer_id` (string, required)
    El ID oficial del empleador, según el país.
    Example: "123456789010"

  - `results.current_employment_records.employer_rfc` (string, required)
    El RFC del empleador (número de identificación fiscal).
    Example: "RFC123456"

  - `results.current_employment_records.state` (string, required)
    El estado geográfico donde se encuentra el empleo.
    Example: "CDMX"

  - `results.current_employment_records.days_employed` (integer, required)
    El número de días que el individuo ha estado empleado con este empleador.
    Example: 365

  - `results.current_employment_records.base_salary` (number,null, required)
    El salario base del individuo.
    Example: 10000

  - `results.current_employment_records.monthly_salary` (number,null, required)
    El salario mensual del individuo, incluidos cualquier beneficio adicional.
    Example: 304166.67

## Response 403 fields (application/json):

  - `code` (string)
    Un código de error único () que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar 403 access_to_resource_denied.
    Example: "access_to_resource_denied"

  - `message` (string)
    Una breve descripción del error.

Para los errores , la descripción es:

  - .
    Example: "You don't have access to this resource."

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 408 fields (application/json):

  - `code` (string)
    Un código de error único () que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 408 request_timeout.
    Example: "request_timeout"

  - `message` (string)
    Una breve descripción del error.

Para los errores de , la descripción es:

  - .
    Example: "The request timed out, you can retry asking for less data by changing your query parameters"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 428 fields (application/json):

  - `code` (string)
    Un código de error único () que te permite clasificar y manejar el error de forma programática. ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 428 token_required.
    Example: "token_required"

  - `message` (string)
    Una breve descripción del error. 
Para los errores , la descripción es:

  - .
    Example: "A MFA token is required by the institution to login"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

  - `session` (string)
    Un ID único de 32 caracteres de la sesión de inicio de sesión (que coincide con un patrón de regex de: ).
    Example: "2675b703b9d4451f8d4861a3eee54449"

  - `expiry` (integer)
    Tiempo de duración de la sesión en segundos.
    Example: 9600

  - `link` (string)
    Identificador único creado por Belvo, utilizado para referenciar el Link actual.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `token_generation_data` (object)
    Detalles sobre cómo generar el token.

  - `token_generation_data.instructions` (string)
    Instrucciones para la generación de tokens.
    Example: "Use this code to generate the token"

  - `token_generation_data.type` (string)
    Tipo de datos para generar el token (código QR, desafío numérico).
    Example: "numeric"

  - `token_generation_data.value` (string)
    Valor a utilizar para generar el token.
    Example: "12345"

  - `token_generation_data.expects_user_input` (boolean)
    Indica si el usuario necesita proporcionar información para completar la autenticación. Cuando se establece en , es posible que su usuario necesite:
- confirmar el inicio de sesión en otro dispositivo
- escanear un código QR
Aún necesitará realizar una llamada PATCH para completar la solicitud.
    Example: true

## Response 500 fields (application/json):

  - `code` (string)
    Un código de error único () que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 500 unexpected_error.
    Example: "unexpected_error"

  - `message` (string)
    Una breve descripción del error.

Para los errores , la descripción es:

- .
    Example: "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"