v1

latestOpenAPI 3.0.22026-08-061464031.4 MB

Current Employments Mexico

List current employments

▶️ Usage

With the List Current Employments method, you can:

List current employments related to a specific link.id (using the link query parameter).
Get the details of a specific current-employment.id (using the id query parameter).
[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.

get/api/mx/current-employments/

Query parameters

idstring uuid

Example:24ccab1d-3a86-4136-a6eb-e04bf52b356f

Return information only for this resource id.

id__instring[]

Return information for these resource ids.

[
  "6b3dea0f-be29-49d1-aabe-1a6d588642e6"
]

linkstring uuid

Example:8848bd0c-9c7e-4f53-a732-ec896b11d4c4

The link.id you want to filter by.

ℹ️ We highly recommend adding the link.id filter in order to improve your performance.

link__instring[]

Return results only for these link.ids.

[
  "5722d0ba-69d7-42dc-8ff5-33767b83c5d6"
]

page_sizeinteger

Example:100

Indicates how many results to return per page. By default we return 100 results per page.

ℹ️ The minimum number of results returned per page is 1 and the maximum is 1000. If you enter a value greater than 1000, our API will default to the maximum value (1000).

pageinteger

Example:1

A page number within the paginated result set.

collected_atstring date

Example:2022-05-01

Return items that were retrieved from the institution on this date (YYYY-MM-DD or full ISO-8601 timestamp).

collected_at__gtstring date

Example:2022-05-05

Return items that were retrieved from the institution after this date (YYYY-MM-DD or full ISO-8601 timestamp).

collected_at__gtestring date

Example:2022-05-04

Return items that were retrieved from the institution after or on this date (YYYY-MM-DD or full ISO-8601 timestamp).

collected_at__ltstring date

Example:2022-04-01

Return items that were retrieved from the institution before this date (YYYY-MM-DD or full ISO-8601 timestamp).

collected_at__ltestring date

Example:2022-03-30

Return items that were retrieved from the institution before or on this date (YYYY-MM-DD or full ISO-8601 timestamp).

collected_at__rangestring[]

Return items that were retrieved from the institution between two dates (YYYY-MM-DD or full ISO-8601 timestamp). The first value indicates the start of the range and the second value indicates the end of the range.

[
  "2022-01-01",
  "2022-12-31"
]

created_atstring date

Example:2022-05-05

Return items that were last updated in Belvo's database on this date (in YYYY-MM-DD format).

created_at__gtstring date

Example:2022-05-05

Return items that were last updated in Belvo's database after this date (in YYYY-MM-DD format).

created_at__gtestring date

Example:2022-05-04

Return items that were last updated in Belvo's database after or on this date (in YYYY-MM-DD format).

created_at__ltstring date

Example:2022-04-01

Return items that were last updated in Belvo's database before this date (in YYYY-MM-DD format).

created_at__ltestring date

Example:2022-03-30

Return items that were last updated in Belvo's database before or on this date (in YYYY-MM-DD format).

created_at__rangestring[]

Return accounts that were last updated in Belvo's database between two dates (in YYYY-MM-DD format). The first value indicates the start of the range and the second value indicates the end of the range.

[
  "2022-01-01",
  "2022-12-31"
]

Response

countinteger

The total number of results in your Belvo account.

nextstring 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).

previousstring uri nullable

The URL to the previous page of results. If there is no previous page, the value is null.

Example response

{
  "count": 130,
  "next": "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908page=2",
  "results": [
    {
      "id": "0d3ffb69-f83b-456e-ad8e-208d0998d71d",
      "link": "30cb4806-6e00-48a4-91c9-ca55968576c8",
      "created_at": "2022-02-09T08:45:50.406032Z",
      "collected_at": "2022-02-09T08:45:50.406032Z",
      "month": "2023-01",
      "internal_identification": "BLPM230130IONVGR54",
      "personal_data": {
        "official_name": "Bruce Banner del Torro",
        "first_name": "Bruce",
        "last_name": "Banner del Torro",
        "birth_date": "1990-02-09",
        "document_ids": [
          {
            "document_type": "NSS",
            "document_number": "10277663582"
          }
        ]
      },
      "status": "EMPLOYED",
      "current_employment_records": [
        {
          "employer": "Batman Enterprises CDMX",
          "employer_id": "123456789010",
          "employer_rfc": "RFC123456",
          "state": "CDMX",
          "days_employed": 365,
          "base_salary": 10000,
          "monthly_salary": 304166.67
        }
      ]
    }
  ]
}