curl --request GET \
--url https://api.gotrebol.com/verifications/{verification-id}/shareholders \
--header 'x-api-key: <api-key>'import requests
url = "https://api.gotrebol.com/verifications/{verification-id}/shareholders"
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.gotrebol.com/verifications/{verification-id}/shareholders', 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.gotrebol.com/verifications/{verification-id}/shareholders",
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.gotrebol.com/verifications/{verification-id}/shareholders"
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.gotrebol.com/verifications/{verification-id}/shareholders")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gotrebol.com/verifications/{verification-id}/shareholders")
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{
"shareholders": [
{
"name": "ACME LLC",
"share_percentage": 60
},
{
"name": "Juan Pérez",
"share_percentage": 40
}
],
"capital": {
"total_value": 1000000,
"currency": "MXN"
},
"source": {
"document": "acta_constitutiva"
},
"shareholders_unavailable_reason": null,
"business_type": "SOCIEDAD ANONIMA DE CAPITAL VARIABLE",
"verification": {
"id": "c8dc41fc-c477-404e-aff7-b9074f86d6d1",
"tag": "etiqueta",
"status": "pending"
}
}{
"success": false,
"message": "Unauthorized",
"code": "UNAUTHORIZED",
"timestamp": "2025-01-01T12:34:56.000Z"
}{
"success": false,
"message": "Entity not found",
"code": "NOT_FOUND",
"timestamp": "2025-01-01T12:34:56.000Z"
}{
"success": false,
"message": "Internal server error",
"code": "INTERNAL_SERVER_ERROR",
"timestamp": "2025-01-01T12:34:56.000Z"
}Obtener accionistas de la empresa de las actas por el ID de Verificacion
Obtener la lista de accionistas asociados con una empresa usando el id de la verificación.
curl --request GET \
--url https://api.gotrebol.com/verifications/{verification-id}/shareholders \
--header 'x-api-key: <api-key>'import requests
url = "https://api.gotrebol.com/verifications/{verification-id}/shareholders"
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.gotrebol.com/verifications/{verification-id}/shareholders', 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.gotrebol.com/verifications/{verification-id}/shareholders",
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.gotrebol.com/verifications/{verification-id}/shareholders"
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.gotrebol.com/verifications/{verification-id}/shareholders")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gotrebol.com/verifications/{verification-id}/shareholders")
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{
"shareholders": [
{
"name": "ACME LLC",
"share_percentage": 60
},
{
"name": "Juan Pérez",
"share_percentage": 40
}
],
"capital": {
"total_value": 1000000,
"currency": "MXN"
},
"source": {
"document": "acta_constitutiva"
},
"shareholders_unavailable_reason": null,
"business_type": "SOCIEDAD ANONIMA DE CAPITAL VARIABLE",
"verification": {
"id": "c8dc41fc-c477-404e-aff7-b9074f86d6d1",
"tag": "etiqueta",
"status": "pending"
}
}{
"success": false,
"message": "Unauthorized",
"code": "UNAUTHORIZED",
"timestamp": "2025-01-01T12:34:56.000Z"
}{
"success": false,
"message": "Entity not found",
"code": "NOT_FOUND",
"timestamp": "2025-01-01T12:34:56.000Z"
}{
"success": false,
"message": "Internal server error",
"code": "INTERNAL_SERVER_ERROR",
"timestamp": "2025-01-01T12:34:56.000Z"
}Authorizations
Path Parameters
El ID de la verificación.
Response
Accionistas de la verificación recuperados exitosamente.
Lista de accionistas detectados en las actas
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Por qué shareholders viene vacío: business_type_without_shareholders cuando el tipo de sociedad no tiene accionistas y la lista vacía es final, pending_extraction cuando hay un acta en extracción, null cuando no hay motivo que reportar. Los dos campos siempre están presentes: lo opcional es el valor, no su presencia. Nunca se omiten del objeto, ni siquiera cuando hay accionistas — en ese caso shareholders_unavailable_reason llega en null. Campo aditivo, disponible desde el 20 de agosto de 2026. Ver Motivo cuando la lista de accionistas viene vacía.
business_type_without_shareholders, pending_extraction, null null
Tipo de sociedad del que Trébol derivó el motivo, tal como está escrito en el documento. Campo aditivo, disponible desde el 20 de agosto de 2026.
"SOCIEDAD ANONIMA DE CAPITAL VARIABLE"
Show child attributes
Show child attributes
Was this page helpful?