---
title: "List current employments"
method: GET
path: "/api/mx/current-employments/"
tags: ["Current Employments Mexico"]
---

# List current employments

`GET /api/mx/current-employments/`

## ▶️ Usage

With the List Current Employments method, you can:

1. List current employments related to a specific `link.id` (using the `link` query parameter).
2. Get the details of a specific `current-employment.id` (using the `id` query parameter).
3. **[Not Recommended]** List all current employments related to your Belvo account (without using any query parameters).

## 📖 Pagination

This method returns a paginated response (default: 100 items per page). You can use the `page_size` query parameter to increase the number of items returned to a maximum of 1000 items. You can use the `page` query parameter to navigate through the results. For more details on how to navigate Belvo's paginated responses, see our <a href="https://developers.belvo.com/docs/belvo-pagination-tips" target="_blank">Pagination Tips</a> article.

## 🔦 Filtering Responses

Please see the query list below for a list of fields that you can filter your responses by. For more information on how to use filters, see our <a href="https://developers.belvo.com/docs/searching-and-filtering" target="_blank">Filtering responses</a> article.

## Query parameters

- `id` string, uuid
- `id__in` string[]
- `link` string, uuid
- `link__in` string[]
- `page_size` integer
- `page` integer
- `collected_at` string, date
- `collected_at__gt` string, date
- `collected_at__gte` string, date
- `collected_at__lt` string, date
- `collected_at__lte` string, date
- `collected_at__range` string[]
- `created_at` string, date
- `created_at__gt` string, date
- `created_at__gte` string, date
- `created_at__lt` string, date
- `created_at__lte` string, date
- `created_at__range` string[]

## Response `200`

Ok

- object
  - `count` integer — The total number of results in your Belvo account.
  - `next` string, uri, nullable — The URL to next page of results. Each page consists of up to 100 items. If there are not enough results for an additional page, the value is `null`. In our documentation example, we use `{endpoint}` as a placeholder value. In production, this value will be replaced by the actual endpoint you are currently using (for example, `accounts` or `owners`).
  - `previous` string, uri, nullable — The URL to the previous page of results. If there is no previous page, the value is `null`.
  - `results` CurrentEmployment[]
    - `id` string, uuid, required — Belvo's unique identifier for the current item.
    - `link` string, uuid, nullable, required — The `link.id` the data belongs to.
    - `created_at` string, date-time, required — The ISO-8601 timestamp of when the data point was created in Belvo's database.
    - `collected_at` string, date-time, required — The ISO-8601 timestamp when the data point was collected.
    - `month` string, nullable, required — The month for which the current employment status is reported, in `YYYY-MM` format. If `status` is `UNEMPLOYED`, this field is `null`.
    - `internal_identification` string, nullable, required — Unique ID for user according to the institution. For IMSS and ISSSTE Mexico, this is the CURP. If `status` is `UNEMPLOYED`, this field is `null`.
    - `personal_data` CurrentEmploymentPersonalData, required — Details regarding the personal information of the individual.
      - `official_name` string, nullable, required — The legal name of the individual.
      - `first_name` string, nullable, required — The first name of the individual.
      - `last_name` string, nullable, required — The last name of the individual.
      - `birth_date` string, date, nullable, required — The date of birth of the individual, in `YYYY-MM-DD` format.
      - `document_ids` CurrentEmploymentDocumentId[], required — Details regarding the individual's ID documents.
        - `document_type` 'NSS' | 'CURP' | 'RFC', nullable, required — The type of document related to the individual. We return one of the following values: - `NSS` - `CURP` - `RFC`
        - `document_number` string, nullable, required — The ID document's number (as a string).
    - `status` 'EMPLOYED' | 'UNEMPLOYED', required — The current employment status of the individual.
    - `current_employment_records` CurrentEmploymentRecord[], nullable, required — Details regarding the individual's current employment. If `status` is `UNEMPLOYED`, this field is `null`.
      - `employer` string, required — The official name of the employer.
      - `employer_id` string, required — The official ID of the employer, according to the country.
      - `employer_rfc` string, required — The employer's RFC (tax identification number).
      - `state` string, required — The geographical state where the employment is located.
      - `days_employed` integer, required — The number of days the individual has been employed with this employer.
      - `base_salary` number, float, nullable, required — The base salary of the individual.
      - `monthly_salary` number, float, nullable, required — The monthly salary of the individual, including any additional perks.

## Other responses

- `400` — Bad request error
- `401` — Unauthorized
- `403` — Access to Belvo API denied
- `408` — Request Timeout
- `428` — MFA Token Required
- `500` — Unexpected Error

---

[API](https://skmtc.net/belvo/apis/belvo-api-docs.md) · [All operations](https://skmtc.net/belvo/apis/belvo-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/belvo/belvo-api-docs/revisions/e82dca4a4b97/schema)