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>'{
"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ón
Fuentes (sources) y extracciones automáticas: cuando la cuenta tiene una extracción automática activa 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 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>'{
"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 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