Obtener sección por etiqueta de empresa
curl --request GET \
--url https://api.gotrebol.com/v2/companies/{etiqueta}/{section} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.gotrebol.com/v2/companies/{etiqueta}/{section}"
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/v2/companies/{etiqueta}/{section}', 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/v2/companies/{etiqueta}/{section}",
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/v2/companies/{etiqueta}/{section}"
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/v2/companies/{etiqueta}/{section}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gotrebol.com/v2/companies/{etiqueta}/{section}")
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{
"success": true,
"data": {
"verification": {
"id": "c8dc41fc-c477-404e-aff7-b9074f86d6d1",
"account_id": "99999999-9999-9999-9999-999999999999",
"tag": "mi-etiqueta",
"created_at": "2025-04-28T20:10:06.840Z",
"comments_legal_review": [
"Nombre inconsistente en acta 2019"
],
"business_name": {
"value": "TREBOL OPCO S.A. DE C.V.",
"validations": []
},
"flow_id": "documents-v2",
"onboarding_url": "https://onboarding.gotrebol.com/verification/c8dc41fc...",
"documents_status": "full_upload",
"created_by": "99999999-9999-9999-9999-999999999999",
"status": "pending",
"country": "mx",
"tax_id": "SAG160927GIA"
},
"legal": {
"business_name": {
"value": "TREBOL OPCO S.A. DE C.V.",
"source": {
"item_id": 123,
"item_type": "ac_mx",
"document_url": null,
"document_date": null,
"document_number": null,
"entity_name": null,
"extra_fields": null,
"information_source": null,
"source_date": null,
"subject_id": null
}
},
"business_type": {
"value": "company",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_folio_number": {
"value": "123456",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_duration": {
"value": "indefinida",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_expiry_date": null,
"business_legal_address": {
"value": "CDMX, México",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_creditor_ability": {
"value": true,
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_asset_pledging": {
"value": false,
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_guarantor_ability": {
"value": true,
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"latest_acta_date": {
"value": "2024-10-12",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
}
},
"registration": {
"has_constitutive": {
"value": true,
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_name": {
"value": "TREBOL OPCO S.A. DE C.V.",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"acta_number": {
"value": "12,345",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"notary_number": {
"value": "112",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"notary_name": {
"value": "Lic. Pérez",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_type": {
"value": "S.A. de C.V.",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"folio_number": {
"value": "FN-123",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"folio_date": {
"value": "2020-03-01",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"folio_inscription_date": {
"value": "2020-03-15",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"city": {
"value": "CDMX",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"state": {
"value": "Ciudad de México",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"registration_date": {
"value": "2020-03-01",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
}
},
"tax": {
"has_constancia": {
"value": true,
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_name": {
"value": "TREBOL OPCO S.A. DE C.V.",
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_type": {
"value": "company",
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_tax_id": {
"value": "SAG160927GIA",
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_main_activity": {
"value": [
{
"order": 1,
"economic_activity": "Servicios de software",
"percentage": 100,
"date": "2024-01-01"
}
],
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_fiscal_status": {
"value": "ACTIVO",
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"qr_validation": {
"value": true,
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_regime": {
"value": "Régimen General",
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"additional_data": {
"value": {
"qr_status": "valid"
},
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
}
},
"signatory_validation": {
"full_name": {
"value": "Juan Pérez",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"paternal_last_name": {
"value": "Pérez",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"maternal_last_name": {
"value": "García",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"document_number": {
"value": "INE-123",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"validation_status": {
"value": "match",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"validation_value": {
"value": "Juan Pérez",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"validation_date": {
"value": "2025-01-15",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"name_comparison_result": {
"value": "strong_match",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"id_validation_provider": {
"value": {
"provider_name": "qDetect",
"provider_id": "qd-01",
"provider_details_url": "https://..."
},
"source": {
"item_id": 789,
"item_type": "person_id"
}
}
},
"banking": {
"address": {
"value": "Calle Falsa 123, CDMX",
"source": {
"item_id": 901,
"item_type": "bank_statement"
}
},
"entity_name": {
"value": "BBVA",
"source": {
"item_id": 901,
"item_type": "bank_statement"
}
},
"document_date": {
"value": "2024-12-01",
"source": {
"item_id": 901,
"item_type": "bank_statement"
}
},
"additional_data": {
"value": {
"rfc": "SAG160927GIA",
"clabe_number": "012345678901234567"
},
"source": {
"item_id": 901,
"item_type": "bank_statement"
}
}
},
"address": {
"business_fiscal_address": {
"value": "CDMX, México",
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_fiscal_address_disaggregated": {
"value": {
"street_type": "CALLE",
"street_name": "Falsa",
"external_number": "123",
"internal_number": "2",
"neighborhood": "Centro",
"district": "Cuauhtémoc",
"state": "CDMX",
"post_code": "06000"
},
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_comercial_address": {
"value": "CDMX, México",
"source": {
"item_id": 901,
"item_type": "bank_statement"
}
}
}
},
"meta": {
"section": "details",
"verification": {
"id": "c8dc41fc-c477-404e-aff7-b9074f86d6d1",
"tag": "mi-etiqueta",
"status": "pending"
}
}
}Leer información de la empresa
Obtener sección por etiqueta de empresa
Retorna datos públicos v2 de una sección específica de una empresa a partir de su etiqueta.
Secciones disponibles:
details: Detalles de la empresa (información legal, fiscal, registro, etc.)shareholders: Accionistas y capital socialpeople: Personas clave, apoderados y representantes legalesdocuments: Documentos asociados a la verificaciónsources: Fuentes de información (items) que alimentan la verificaciónexternal-lookups: Evidencia de auditoría de las consultas a fuentes públicas (SAT, RENAPO, INE, SIGER). Ver Consultas públicas externas.
Fuentes (sources) y extracciones personalizadas: cuando la cuenta tiene una extracción personalizada activa o un tipo de ítem personalizado con procesos de extracción, cada elemento en data.sources puede incluir custom_user_prompts: un objeto cuyas claves son el identificador del procesamiento (prompt_id para extracciones personalizadas o process_reference para tipos de ítem personalizados) y cuyos valores son el JSON extraído según el esquema de la versión en uso. Más detalle en las guías Extracciones personalizadas y Tipos de ítem personalizados.
Coordenadas de citas: agrega ?with_citations=true para obtener URLs firmadas al artifact de coordenadas. Según la sección: people y shareholders añaden data.citations.url; sources añade citations.url en cada item de tipo acta del array data.sources. Detalle completo en Coordenadas de citas.
Endpoints v1 (Legacy)
Endpoints v1 (Legacy)
Estos endpoints están en modo legacy. Te recomendamos migrar al endpoint v2 que consolida toda esta funcionalidad en un solo endpoint con mejor estructura de datos.
Los siguientes endpoints v1 están disponibles para compatibilidad con implementaciones existentes:
- Obtener estatutos de las actas por la Etiqueta
- Obtener documentos de la empresa
- Obtener apoderados y representantes legales de la empresa de las actas por la Etiqueta
- Obtener accionistas de las actas de la empresa por la Etiqueta
- Obtener la informacion de la prevalidacion de documentos asosciados a una empresa
GET
/
v2
/
companies
/
{etiqueta}
/
{section}
Obtener sección por etiqueta de empresa
curl --request GET \
--url https://api.gotrebol.com/v2/companies/{etiqueta}/{section} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.gotrebol.com/v2/companies/{etiqueta}/{section}"
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/v2/companies/{etiqueta}/{section}', 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/v2/companies/{etiqueta}/{section}",
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/v2/companies/{etiqueta}/{section}"
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/v2/companies/{etiqueta}/{section}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gotrebol.com/v2/companies/{etiqueta}/{section}")
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{
"success": true,
"data": {
"verification": {
"id": "c8dc41fc-c477-404e-aff7-b9074f86d6d1",
"account_id": "99999999-9999-9999-9999-999999999999",
"tag": "mi-etiqueta",
"created_at": "2025-04-28T20:10:06.840Z",
"comments_legal_review": [
"Nombre inconsistente en acta 2019"
],
"business_name": {
"value": "TREBOL OPCO S.A. DE C.V.",
"validations": []
},
"flow_id": "documents-v2",
"onboarding_url": "https://onboarding.gotrebol.com/verification/c8dc41fc...",
"documents_status": "full_upload",
"created_by": "99999999-9999-9999-9999-999999999999",
"status": "pending",
"country": "mx",
"tax_id": "SAG160927GIA"
},
"legal": {
"business_name": {
"value": "TREBOL OPCO S.A. DE C.V.",
"source": {
"item_id": 123,
"item_type": "ac_mx",
"document_url": null,
"document_date": null,
"document_number": null,
"entity_name": null,
"extra_fields": null,
"information_source": null,
"source_date": null,
"subject_id": null
}
},
"business_type": {
"value": "company",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_folio_number": {
"value": "123456",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_duration": {
"value": "indefinida",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_expiry_date": null,
"business_legal_address": {
"value": "CDMX, México",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_creditor_ability": {
"value": true,
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_asset_pledging": {
"value": false,
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_guarantor_ability": {
"value": true,
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"latest_acta_date": {
"value": "2024-10-12",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
}
},
"registration": {
"has_constitutive": {
"value": true,
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_name": {
"value": "TREBOL OPCO S.A. DE C.V.",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"acta_number": {
"value": "12,345",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"notary_number": {
"value": "112",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"notary_name": {
"value": "Lic. Pérez",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"business_type": {
"value": "S.A. de C.V.",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"folio_number": {
"value": "FN-123",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"folio_date": {
"value": "2020-03-01",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"folio_inscription_date": {
"value": "2020-03-15",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"city": {
"value": "CDMX",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"state": {
"value": "Ciudad de México",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
},
"registration_date": {
"value": "2020-03-01",
"source": {
"item_id": 123,
"item_type": "ac_mx"
}
}
},
"tax": {
"has_constancia": {
"value": true,
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_name": {
"value": "TREBOL OPCO S.A. DE C.V.",
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_type": {
"value": "company",
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_tax_id": {
"value": "SAG160927GIA",
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_main_activity": {
"value": [
{
"order": 1,
"economic_activity": "Servicios de software",
"percentage": 100,
"date": "2024-01-01"
}
],
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_fiscal_status": {
"value": "ACTIVO",
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"qr_validation": {
"value": true,
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_regime": {
"value": "Régimen General",
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"additional_data": {
"value": {
"qr_status": "valid"
},
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
}
},
"signatory_validation": {
"full_name": {
"value": "Juan Pérez",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"paternal_last_name": {
"value": "Pérez",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"maternal_last_name": {
"value": "García",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"document_number": {
"value": "INE-123",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"validation_status": {
"value": "match",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"validation_value": {
"value": "Juan Pérez",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"validation_date": {
"value": "2025-01-15",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"name_comparison_result": {
"value": "strong_match",
"source": {
"item_id": 789,
"item_type": "person_id"
}
},
"id_validation_provider": {
"value": {
"provider_name": "qDetect",
"provider_id": "qd-01",
"provider_details_url": "https://..."
},
"source": {
"item_id": 789,
"item_type": "person_id"
}
}
},
"banking": {
"address": {
"value": "Calle Falsa 123, CDMX",
"source": {
"item_id": 901,
"item_type": "bank_statement"
}
},
"entity_name": {
"value": "BBVA",
"source": {
"item_id": 901,
"item_type": "bank_statement"
}
},
"document_date": {
"value": "2024-12-01",
"source": {
"item_id": 901,
"item_type": "bank_statement"
}
},
"additional_data": {
"value": {
"rfc": "SAG160927GIA",
"clabe_number": "012345678901234567"
},
"source": {
"item_id": 901,
"item_type": "bank_statement"
}
}
},
"address": {
"business_fiscal_address": {
"value": "CDMX, México",
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_fiscal_address_disaggregated": {
"value": {
"street_type": "CALLE",
"street_name": "Falsa",
"external_number": "123",
"internal_number": "2",
"neighborhood": "Centro",
"district": "Cuauhtémoc",
"state": "CDMX",
"post_code": "06000"
},
"source": {
"item_id": 456,
"item_type": "csf_mx"
}
},
"business_comercial_address": {
"value": "CDMX, México",
"source": {
"item_id": 901,
"item_type": "bank_statement"
}
}
}
},
"meta": {
"section": "details",
"verification": {
"id": "c8dc41fc-c477-404e-aff7-b9074f86d6d1",
"tag": "mi-etiqueta",
"status": "pending"
}
}
}Authorizations
Path Parameters
Etiqueta de la empresa (tag)
Sección solicitada
Available options:
details, shareholders, people, documents, sources, external-lookups Query Parameters
Aplica a people, shareholders y sources. Si es true:
- Para
peopleyshareholders: añadedata.citations.url, una URL firmada al artifact de coordenadas de esa sección. - Para
sources: añadecitations.urlen cada item de tipo acta dentro dedata.sources. Ver Coordenadas de citas.
Was this page helpful?
⌘I