Obtener sección por ID de verificación
curl --request GET \
--url https://api.gotrebol.com/v2/verifications/{verification-id}/{entity} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.gotrebol.com/v2/verifications/{verification-id}/{entity}"
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/verifications/{verification-id}/{entity}', 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/verifications/{verification-id}/{entity}",
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/verifications/{verification-id}/{entity}"
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/verifications/{verification-id}/{entity}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gotrebol.com/v2/verifications/{verification-id}/{entity}")
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 ID de verificación
Retorna datos públicos v2 de una sección específica de una verificación a partir de su id.
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 para el tipo de ítem correspondiente, cada elemento en data.sources puede incluir una llave cp_<prompt_id> por cada extracción con resultado, donde prompt_id es el identificador editable de la extracción personalizada y el valor es el JSON extraído según el esquema de la versión en uso. Más detalle en la guía Extracciones personalizadas. Los ítems de tipos de ítem personalizados (cit_*) no exponen aquí sus resultados: se leen desde el ítem, en item_value.pipeline. Ver 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 el ID de Verificacion
- Obtener documentos de la empresa por id de verificacion
- Obtener apoderados y representates legales de la empresa de las actas por el ID de Verificacion
- Obtener accionistas de la empresa de las actas por el ID de Verificacion
- Obtener datos de prevalidacion de documentos
GET
/
v2
/
verifications
/
{verification-id}
/
{entity}
Obtener sección por ID de verificación
curl --request GET \
--url https://api.gotrebol.com/v2/verifications/{verification-id}/{entity} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.gotrebol.com/v2/verifications/{verification-id}/{entity}"
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/verifications/{verification-id}/{entity}', 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/verifications/{verification-id}/{entity}",
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/verifications/{verification-id}/{entity}"
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/verifications/{verification-id}/{entity}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gotrebol.com/v2/verifications/{verification-id}/{entity}")
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
ID de la verificación
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?