Skip to main content
GET
/
datasources
/
mx
/
company-verification
/
reports
/
{reportId}
/
found-entities
/
{id}
Get a specific found entity
curl --request GET \
  --url https://api.syntage.com/datasources/mx/company-verification/reports/{reportId}/found-entities/{id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "82bc6789-2345-6789-abcd-ef0123456789",
  "fullName": "Juan Pérez García",
  "nameVariations": [
    "Juan Perez Garcia",
    "J. Pérez García"
  ],
  "entityType": "person",
  "isActive": true,
  "holdings": [
    {
      "id": "73cd5678-3456-7890-bcde-f01234567890",
      "capitalType": "fixed",
      "shares": 3000,
      "amount": "30000.0000",
      "bucketPercentage": "60.0000",
      "series": "A",
      "valuePerShare": "10.0000"
    }
  ],
  "powers": [
    {
      "id": "64de4567-4567-8901-cdef-123456789012",
      "status": "current",
      "grantedAt": "2020-01-15T00:00:00+00:00",
      "documentSource": "rpc",
      "documentNumber": "12345",
      "power": "administrative_acts",
      "expirationDate": "2025-01-15T00:00:00+00:00",
      "expirationSource": "document",
      "documentGrantingState": "CDMX",
      "referenceExternal": false,
      "referenceText": "<string>",
      "referenceDocumentNumber": "<string>",
      "exerciseJointlyWith": "<string>",
      "exerciseJointlyRequired": false,
      "exerciseSubstitutionAllowed": false,
      "exerciseLimitations": "<string>",
      "realEstateCanAcquire": false,
      "realEstateCanDispose": false
    }
  ],
  "createdAt": "2020-01-01T12:15:00.000Z",
  "updatedAt": "2020-01-01T12:15:00.000Z",
  "@context": "<unknown>",
  "@id": "/datasources/mx/company-verification/reports/91ab5678-1234-5678-9abc-def012345678/found-entities/82bc6789-2345-6789-abcd-ef0123456789",
  "@type": "FoundEntity",
  "totalsShares": 5000,
  "totalsAmount": "50000.0000",
  "totalsPercentage": "25.0000",
  "firstAppearanceDate": "2020-01-15"
}

Authorizations

​
X-API-Key
string
header
required

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

Path Parameters

​
reportId
string<uuid>
required

Identifier of the Company Verification report.

​
id
string<uuid>
required

Response

Company Verification Report Found Entity

A person or company identified in the source documents of a Mexican Company Verification report. Includes administrators, shareholders, and legal representatives — disambiguated by the upstream pipeline and merged across name variations.

​
id
string<uuid>
required
Example:

"82bc6789-2345-6789-abcd-ef0123456789"

​
fullName
string
required

Full name of the entity, as resolved by the upstream pipeline.

Example:

"Juan Pérez García"

​
nameVariations
string[]
required

Alternative spellings of the full name observed across source documents.

Example:
["Juan Perez Garcia", "J. Pérez García"]
​
entityType
enum<string>
required

Whether the entity is a natural person or a legal entity.

Available options:
person,
company
Example:

"person"

​
isActive
boolean
required

Whether this entity still holds shares at the report cut-off date.

Example:

true

​
holdings
object[]
required

Granular cap-table holdings, one row per (capitalType, series) bucket this entity appears in.

​
powers
object[]
required

Powers of attorney granted to this entity. Includes both current and expired records, discriminated by status.

​
createdAt
string
required

Date and time the resource was created

Example:

"2020-01-01T12:15:00.000Z"

​
updatedAt
string
required

Date and time the resource was last updated

Example:

"2020-01-01T12:15:00.000Z"

​
@context
any
​
@id
string<iri-reference>
Example:

"/datasources/mx/company-verification/reports/91ab5678-1234-5678-9abc-def012345678/found-entities/82bc6789-2345-6789-abcd-ef0123456789"

​
@type
string
default:FoundEntity
​
totalsShares
integer | null

Sum of shares this entity holds across every (capitalType, series) bucket. null when the entity has no cap-table data extracted (for example, a legal representative that only appears in powers).

Example:

5000

​
totalsAmount
string | null

Sum of monetary value this entity holds across every (capitalType, series) bucket.

Example:

"50000.0000"

​
totalsPercentage
string | null

Ownership percentage held by this entity at the report cut-off date.

Example:

"25.0000"

​
firstAppearanceDate
string<date> | null

Date on which this entity first appears as a shareholder in the report source documents.

Example:

"2020-01-15"