curl --request GET \
--url https://api.syntage.com/entities/{entityId}/insights/corporate-structure/current-powers \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.syntage.com/entities/{entityId}/insights/corporate-structure/current-powers"
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/entities/{entityId}/insights/corporate-structure/current-powers', 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/entities/{entityId}/insights/corporate-structure/current-powers",
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/entities/{entityId}/insights/corporate-structure/current-powers"
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/entities/{entityId}/insights/corporate-structure/current-powers")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntage.com/entities/{entityId}/insights/corporate-structure/current-powers")
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{
"@context": "/contexts/CorporateStructureCurrentPowersEntityResponse",
"@id": "/entities/91ab5678-1234-5678-9abc-def012345678/insights/corporate-structure/current-powers",
"@type": "hydra:Collection",
"hydra:member": [
{
"name": "Juan Pérez García",
"entityType": "person",
"powers": [
{
"status": "current",
"grantedAt": "2020-01-15",
"documentSource": "rpc",
"documentNumber": "12345",
"externalReference": false,
"exerciseJointlyRequired": false,
"exerciseSubstitutionAllowed": false,
"realEstateCanAcquire": false,
"realEstateCanDispose": false,
"power": "administrative_acts",
"expirationDate": "2025-01-15",
"expirationSource": "document",
"grantingState": "CDMX",
"referenceText": "<string>",
"referenceDocumentNumber": "<string>",
"exerciseJointlyWith": "<string>",
"exerciseLimitations": "<string>"
}
]
}
],
"hydra:totalItems": 1,
"hydra:view": {
"@id": "<string>",
"@type": "hydra:PartialCollectionView",
"hydra:first": "<string>",
"hydra:next": "<string>",
"hydra:last": "<string>"
},
"hydra:search": {
"@type": "<string>",
"hydra:template": "<string>",
"hydra:variableRepresentation": "<string>",
"hydra:mapping": [
{
"@type": "<string>",
"variable": "<string>",
"property": "<string>",
"required": true
}
]
}
}{
"message": "<string>"
}{
"message": "<string>"
}Current Powers Insight
List the people and companies that hold at least one currently effective power of attorney, drawn from the most recent Company Verification report registered for the entity.
Each row carries the identity of a person or company with at least one currently effective power from the entity’s most recent Company Verification report. Holders whose powers have all expired are omitted.
To retrieve shareholders and the latest capital table from Company
Verification, use the shareholders metrics insight at
/entities/{entityId}/insights/metrics/shareholders.
When the entity has no Company Verification report yet, the response
is an empty collection (hydra:totalItems of 0).
curl --request GET \
--url https://api.syntage.com/entities/{entityId}/insights/corporate-structure/current-powers \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.syntage.com/entities/{entityId}/insights/corporate-structure/current-powers"
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/entities/{entityId}/insights/corporate-structure/current-powers', 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/entities/{entityId}/insights/corporate-structure/current-powers",
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/entities/{entityId}/insights/corporate-structure/current-powers"
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/entities/{entityId}/insights/corporate-structure/current-powers")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntage.com/entities/{entityId}/insights/corporate-structure/current-powers")
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{
"@context": "/contexts/CorporateStructureCurrentPowersEntityResponse",
"@id": "/entities/91ab5678-1234-5678-9abc-def012345678/insights/corporate-structure/current-powers",
"@type": "hydra:Collection",
"hydra:member": [
{
"name": "Juan Pérez García",
"entityType": "person",
"powers": [
{
"status": "current",
"grantedAt": "2020-01-15",
"documentSource": "rpc",
"documentNumber": "12345",
"externalReference": false,
"exerciseJointlyRequired": false,
"exerciseSubstitutionAllowed": false,
"realEstateCanAcquire": false,
"realEstateCanDispose": false,
"power": "administrative_acts",
"expirationDate": "2025-01-15",
"expirationSource": "document",
"grantingState": "CDMX",
"referenceText": "<string>",
"referenceDocumentNumber": "<string>",
"exerciseJointlyWith": "<string>",
"exerciseLimitations": "<string>"
}
]
}
],
"hydra:totalItems": 1,
"hydra:view": {
"@id": "<string>",
"@type": "hydra:PartialCollectionView",
"hydra:first": "<string>",
"hydra:next": "<string>",
"hydra:last": "<string>"
},
"hydra:search": {
"@type": "<string>",
"hydra:template": "<string>",
"hydra:variableRepresentation": "<string>",
"hydra:mapping": [
{
"@type": "<string>",
"variable": "<string>",
"property": "<string>",
"required": true
}
]
}
}{
"message": "<string>"
}{
"message": "<string>"
}corporate-structure-current-powers as the insight name.GET /entities/{entityId}/insights/metrics/shareholders with relations.relationType=shareholders. When Company Verification data is available, that insight uses shareholder rows from the entity’s most recent report; manually entered values take precedence for relations that have both sources.Authorizations
Your API key is available in the Production and Sandbox dashboards.
Path Parameters
Query Parameters
Page number for pagination
x >= 1Number of items per page
1 <= x <= 1000Response
Corporate Structure Current Powers Insight
"/entities/91ab5678-1234-5678-9abc-def012345678/insights/corporate-structure/current-powers"
Show child attributes
Show child attributes
Total number of items found
x >= 01
Pagination information
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Was this page helpful?