Skip to main content
GET
Get a specific found entity

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:
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"