curl --request GET \
--url https://api.syntage.com/datasources/mx/company-verification/reports/{reportId}/found-entities/{id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.syntage.com/datasources/mx/company-verification/reports/{reportId}/found-entities/{id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.syntage.com/datasources/mx/company-verification/reports/{reportId}/found-entities/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.syntage.com/datasources/mx/company-verification/reports/{reportId}/found-entities/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.syntage.com/datasources/mx/company-verification/reports/{reportId}/found-entities/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.syntage.com/datasources/mx/company-verification/reports/{reportId}/found-entities/{id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntage.com/datasources/mx/company-verification/reports/{reportId}/found-entities/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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"
}{
"message": "<string>"
}{
"message": "<string>"
}Get a specific found entity
Retrieve a single found entity, with its cap-table holdings and powers expanded inline.
curl --request GET \
--url https://api.syntage.com/datasources/mx/company-verification/reports/{reportId}/found-entities/{id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.syntage.com/datasources/mx/company-verification/reports/{reportId}/found-entities/{id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.syntage.com/datasources/mx/company-verification/reports/{reportId}/found-entities/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.syntage.com/datasources/mx/company-verification/reports/{reportId}/found-entities/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.syntage.com/datasources/mx/company-verification/reports/{reportId}/found-entities/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.syntage.com/datasources/mx/company-verification/reports/{reportId}/found-entities/{id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntage.com/datasources/mx/company-verification/reports/{reportId}/found-entities/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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"
}{
"message": "<string>"
}{
"message": "<string>"
}Authorizations
Your API key is available in the Production and Sandbox dashboards.
Path Parameters
Identifier of the Company Verification report.
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.
"82bc6789-2345-6789-abcd-ef0123456789"
Full name of the entity, as resolved by the upstream pipeline.
"Juan Pérez García"
Alternative spellings of the full name observed across source documents.
["Juan Perez Garcia", "J. Pérez García"]
Whether the entity is a natural person or a legal entity.
person, company "person"
Whether this entity still holds shares at the report cut-off date.
true
Granular cap-table holdings, one row per (capitalType, series) bucket this entity appears in.
Show child attributes
Show child attributes
Powers of attorney granted to this entity. Includes both current and expired records, discriminated by status.
Show child attributes
Show child attributes
Date and time the resource was created
"2020-01-01T12:15:00.000Z"
Date and time the resource was last updated
"2020-01-01T12:15:00.000Z"
"/datasources/mx/company-verification/reports/91ab5678-1234-5678-9abc-def012345678/found-entities/82bc6789-2345-6789-abcd-ef0123456789"
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).
5000
Sum of monetary value this entity holds across every (capitalType, series) bucket.
"50000.0000"
Ownership percentage held by this entity at the report cut-off date.
"25.0000"
Date on which this entity first appears as a shareholder in the report source documents.
"2020-01-15"
Was this page helpful?