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>'{
"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ón
Fuentes (sources) y extracciones automáticas: cuando la cuenta tiene una extracción automática activo para el tipo de ítem correspondiente, cada elemento en data.sources puede incluir custom_user_prompts: un objeto cuyas claves son el identificador editable de la extracción automática (prompt_id) y cuyos valores son el JSON extraído según el esquema de la versión en uso. Más detalle en la guía Extracciones automáticas.
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>'{
"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 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