BUburodeingresos
Individual Information

Get Profile

Changed on

Retrieves profile information for an individual identified by an 18-char CURP. Includes estimated_monthly_income, an estimated net monthly income in MXN derived from the last 90 days of invoices and employment records, falling back to up to 12 months of salary data when that window has none.

Also includes tenure, the verifiable job tenure with the current employer, only produced for employed profiles: a floor bucket (3_months_plus to 12_months_plus), never an exact figure, or less_than_3_months when the evidence of the current employer covers less than 3 months.

get/profile/{identifier}

Request

Path parameters

identifierstring required
Example:CUAI911021MOCRQS09

The CURP of the individual.

Query parameters

institution'imss' | 'issste'
Example:imss

Optional. Filters the profile data by the institution that reported it. If not provided, data from all institutions is returned. When this filter is applied, tenure is returned as null, since it is computed over the whole unfiltered dataset.

Response

Profile data for the identifier.

identifierstring

The identifier (CURP or RFC) associated with the profile.

updated_atstring date-time

Timestamp of the last data update for this profile.

employment_status'employed' | 'self_employed' | 'unemployed' | 'retired' | 'unknown'

Deprecated. Use employment_status from GET /estimates/{identifier} instead. This field is still returned and keeps working; we'll announce a removal date in advance.

The current employment status.

estimated_monthly_incomestring decimal nullable

Deprecated. Use monthly_income from GET /estimates/{identifier} instead. This field is still returned and keeps working; we'll announce a removal date in advance.

Estimated net monthly income in MXN (BigDecimal), derived from the last 90 days of invoices and employment records. When that window has no salary data and no billing activity, it falls back to the most recent payroll invoices (nómina) or employment record from the last 12 months. Returns null when no income data is available. See https://developers.burodeingresos.com/docs/profile#estimated-monthly-income for the calculation.

tenure'less_than_3_months' | '3_months_plus' | '6_months_plus' | '9_months_plus' | '12_months_plus' nullable

Deprecated. Use tenure from GET /estimates/{identifier} instead. This field is still returned and keeps working; we'll announce a removal date in advance.

Verifiable job tenure with the individual's current employer, as a coarse bucket. The _plus buckets are lower bounds: 12_months_plus means "at least 12 months can be verified", never "exactly 12 months" — the real tenure may be longer. less_than_3_months means there is evidence of the current employer, but it covers less than 3 months, e.g. right after a job change. Resets when the person changes employer. Do not present this field as a hire date or an exact seniority figure.

Only produced for profiles with employment_status = employed. null means it doesn't apply or is unknown: any other status, or employed with no employer-level evidence.

Sources, in priority order: (1) the span of payroll invoices (nóminas) issued by the current employer, considered active when the most recent nómina is within 60 days; (2) an active employment record (end_date = null). Note that payroll extraction typically reaches back around 12 months, so 12_months_plus is the top bucket even for much longer tenures.

Returns null when the institution filter is used, since the value is computed over the whole (unfiltered) dataset.

Example response

{
  "personal_info": {
    "tax_regime": "Sueldos y Salarios e Ingresos Asimilados a Salarios"
  },
  "estimated_monthly_income": "11139.00",
  "tenure": "12_months_plus"
}

Changes

  • 98eb3984cffbRevision changes
    • info

      api tag Individual Information added

    • info

      api tag Individuals removed

    • info

      added the optional property to the response with the status

    • info

      response property employment_status deprecated

    • info

      response property estimated_monthly_income deprecated