Get Estimates

Computes monthly_income, employment_status and tenure for an individual identified by an 18-char CURP, with the settings you choose: how many months of history to use, which sources, and as of which date. Optionally returns a monthly history: one point-in-time estimate per month.

The values are computed on every request and never stored; GET /profile is not affected. Same access rules as GET /profile: a valid consent and a verification by your company in the last 90 days. This call does not create a verification and is not billed.

With window_months=3 and the other defaults, the values match GET /profile. The default 12-month window gives a broader estimate. All three values are estimates derived from the available data.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The CURP of the individual.

Query Params
integer
enum
Defaults to 12

Months of history used: invoices, payroll invoices (nóminas), and maximum age of IMSS/ISSSTE data. Windows longer than the available history use whatever history exists.

Allowed:
string
enum
Defaults to all

Data used for all three estimates. invoices: payroll invoices (nóminas) and own billing (ingreso minus egreso). employments: IMSS/ISSSTE records only. all: both.

Allowed:
date

Computes the estimates as of this date (YYYY-MM-DD, Mexico City time), using only data dated on or before it. Defaults to today. Cannot be in the future, and as_of minus window_months must be within the last 24 months. Invoices are exact for any date; IMSS/ISSSTE records use the salary on the current record, because their past salaries are not kept.

boolean
Defaults to false

When true, adds a history array with one point-in-time estimate per month, going back from the month of as_of, up to 18 months.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json