Skip to main content
GET
/
entities
/
{entityId}
/
insights
/
summary
Get entity summary
curl --request GET \
  --url https://api.syntage.com/entities/{entityId}/insights/summary \
  --header 'X-API-Key: <api-key>'
{
  "rfc": "PEIC211118IS0",
  "name": "FOO BAR, S.A. DE C.V.",
  "fiscalAddress": "AV. EJEMPLO 123, COL. CENTRO, 06000, CUAUHTÉMOC, CIUDAD DE MÉXICO",
  "fiscalAddressStatusRaw": "Domicilio Localizado",
  "economicActivities": [
    {
      "name": "Comercio al por mayor de abarrotes",
      "percentage": 100,
      "startDate": "2014-01-01",
      "endDate": null
    }
  ],
  "taxRegimes": [
    {
      "name": "Régimen General de Ley Personas Morales",
      "startDate": "2014-01-01",
      "endDate": null
    }
  ],
  "totalEmployees": 42,
  "lastYearNetIncome": 12000000,
  "lastYearTotalIncome": 12000000,
  "totalRevenueLastTaxReturn": 5000000,
  "totalNetProfitLastTaxReturn": 1500000,
  "lastTaxReturnYear": 2024,
  "totalSalesRevenueCurrentYear": 3500000,
  "registrationDate": "2014-01-15",
  "blacklistStatus": null,
  "lastEfirmaCertificate": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "serialNumber": "00001000000500000000",
    "type": "efirma",
    "status": "active",
    "validFrom": "2023-11-07T05:31:56Z",
    "validTo": "2023-11-07T05:31:56Z",
    "revokedAt": "2023-11-07T05:31:56Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.syntage.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

Example:

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

​
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

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