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

# Retrieve current employments

`POST /api/mx/current-employments/`

Retrieve current employment information for a specific `link.id`.

## Request body

- object
  - `link` string, uuid, required — The `link.id` you want to retrieve information for.
  - `save_data` boolean — Indicates whether or not to persist the data in Belvo. By default, this is set to `true` and we return a 201 Created response. When set to `false`, the data won't be persisted and we return a 200 OK response.

## Response `200`

Ok (when existing)

- 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

- `201` — Created (when new)
- `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)