Skip to main content
GET
Get entity summary

Authorizations

X-API-Key
string
header
required

Your API key is available in the Production and Sandbox dashboards.

Path Parameters

entityId
string<uuid>
required

Response

Summary

rfc
string

RFC (Registro Federal de Contribuyentes)

Required string length: 12 - 13
Example:

"PEIC211118IS0"

name
string | null

Legal or full name of the entity. Taken from the latest Constancia de Situación Fiscal when available, otherwise the entity's stored name.

Example:

"FOO BAR, S.A. DE C.V."

fiscalAddress
string | null

Full fiscal address from the latest Constancia de Situación Fiscal, formatted as a single string.

Example:

"AV. EJEMPLO 123, COL. CENTRO, 06000, CUAUHTÉMOC, CIUDAD DE MÉXICO"

address
object | null

Structured fiscal address from the latest Constancia de Situación Fiscal, exposing the same components that back the fiscalAddress string. Use this object when you need to render address fields individually or geocode the address. null when the entity has no Tax Status on record.

In CSV and XLSX exports, each component is flattened into its own column as address.<component> (for example, address.postalCode).

fiscalAddressStatusRaw
string | null

Raw SAT status string for the fiscal address (e.g. domicilio localizado, no localizado).

Example:

"Domicilio Localizado"

economicActivities
object[]

Economic activities registered with the SAT, filtered to those with no end date or an end date in the future.

taxRegimes
object[]

Tax regimes registered with the SAT, filtered to those with no end date or an end date in the future.

totalEmployees
integer | null

Number of employees reported in the previous calendar month's payroll invoices.

Example:

42

lastYearNetIncome
integer | null
deprecated

Deprecated. Kept for backwards compatibility. Same value as lastYearTotalIncome. Total income for the latest annual tax return's fiscal year, in MXN.

Example:

12000000

lastYearTotalIncome
integer | null

Total income for the latest annual tax return's fiscal year, in MXN.

Example:

12000000

totalRevenueLastTaxReturn
integer | null
deprecated

Deprecated. Kept for backwards compatibility. Prefer totalNetProfitLastTaxReturn. Gross profit (or net loss as a negative value) from the latest annual tax return's income statement, in MXN.

Example:

5000000

totalNetProfitLastTaxReturn
integer | null

Net profit (or net loss as a negative value) from the latest annual tax return's income statement, in MXN.

Example:

1500000

lastTaxReturnYear
integer | null

Fiscal year of the most recent annual tax return used for the income figures above.

Example:

2024

totalSalesRevenueCurrentYear
number | null

Sales revenue in MXN for the current calendar year (from January 1st up to today). Returns null when invoice extractions do not sufficiently cover the year-to-date period.

Example:

3500000

registrationDate
string<date> | null

Date the entity was registered with the SAT.

Example:

"2014-01-15"

blacklistStatus
string | null

Current SAT blacklist status of the entity.

Example:

null

lastEfirmaCertificate
object | null

Metadata about the most recent e.firma (FIEL) certificate on record. Only present when the feature is enabled.