> ## Documentation Index
> Fetch the complete documentation index at: https://gotrebol.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 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 social
- `people`: Personas clave, apoderados y representantes legales
- `documents`: Documentos asociados a la verificación
- `sources`: Fuentes de información (items) que alimentan la verificación
- `external-lookups`: Evidencia de auditoría de las consultas a fuentes públicas (SAT, RENAPO, INE, SIGER). Ver [Consultas públicas externas](/guia-devs/monitorear/consultas-publicas-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](/producto/guias/extracciones-personalizadas) y [Tipos de ítem personalizados](/producto/guias/tipos-de-item-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](/guia-devs/referencia/coordenadas-citas).
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](/docs/api-reference/leer-información-de-la-empresa-v1/obtener-estatutos-de-las-actas-por-el-id-de-verificacion)
- [Obtener documentos de la empresa por id de verificacion](/docs/api-reference/leer-información-de-la-empresa-v1/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](/docs/api-reference/leer-información-de-la-empresa-v1/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](/docs/api-reference/leer-información-de-la-empresa-v1/obtener-accionistas-de-la-empresa-de-las-actas-por-el-id-de-verificacion)
- [Obtener datos de prevalidacion de documentos](/docs/api-reference/leer-información-de-la-empresa-v1/obtener-datos-de-prevalidacion-de-documentos)
## OpenAPI
````yaml /api-reference/openapi.yaml get /v2/verifications/{verification-id}/{entity}
openapi: 3.0.0
info:
title: Coleccion de API KYB MX
description: >
La Colección de API KYB MX proporciona puntos finales para crear y gestionar
verificaciones de empresas en México. La verificación de empresas implica
validar la información proporcionada por un cliente comercial, incluyendo
documentos y fuentes de datos, para asegurar su legitimidad y precisión.
Cada verificación de empresa puede incluir múltiples ítems, como Actas
Constitutivas, Constancias de Situación Fiscal, Identificaciones Personales
y Comprobantes de Domicilio. Trebol maneja automáticamente la clasificación
de documentos, lo que te permite enviar todos los documentos requeridos como
URLs descargables (por ejemplo, URLs prefirmadas de AWS o GCP).
**Autenticación**:
La API utiliza una clave API para la autenticación, pasada en el encabezado
`x-api-key`. Para obtener una clave API, por favor
[contáctanos](mailto:sales@gotrebol.com).
version: 1.0.0
servers:
- url: https://api.gotrebol.com
- url: http://{{trebol_api_base_url}}
security: []
tags:
- name: Creacion de Verificacion
description: Endpoints para crear nuevas verificaciones.
- name: Leer información de la empresa
description: >-
Endpoints v2 para obtener información detallada de empresas y
verificaciones.
- name: Leer por Etiqueta
description: >-
Endpoints para obtener información detallada sobre empresas mediante
etiquetas.
- name: Leer por ID de Verificacion
description: >-
Endpoints para obtener información detallada sobre verificaciones mediante
ID.
- name: Gestión de IPs Permitidas
description: >-
Endpoints para gestionar la lista de IPs permitidas (whitelist) para la
cuenta del cliente.
- name: Gestión de API Keys
description: Endpoints para crear, listar y eliminar API keys de la cuenta del usuario.
- name: Gestion de item Ids
description: Endpoints para gestionar items de verificaciones.
- name: Invalidar un documento
description: Endpoints para invalidar documentos de verificaciones.
- name: Labels de Verificacion
description: Endpoints para gestionar labels de verificaciones.
- name: Actualizar personas clave de una verificacion
description: Endpoints para actualizar personas clave de verificaciones.
- name: Agregar items a una verificacion
description: Endpoints para agregar items a verificaciones existentes.
- name: Estado de validacion de documentos
description: Endpoints para obtener el estado de validación de documentos.
- name: Gestión de Flujos de Cuenta
description: Endpoints para gestionar flujos de cuenta.
- name: Gestión de Webhooks
description: Endpoints para crear, listar, actualizar y eliminar webhooks de la cuenta.
- name: Gestión de Política de Retención
description: Endpoints para gestionar la política de retención de datos de la cuenta.
- name: Exportación de Verificaciones
description: >-
Endpoints para exportar datos de verificaciones a documentos
personalizados.
- name: Leer información de la empresa v1
description: >-
Endpoints v1 (legacy) para obtener información detallada de empresas y
verificaciones. Te recomendamos migrar a los endpoints v2.
- name: Tipos de Ítem Personalizados
description: >-
Endpoints para crear y gestionar tipos de ítem personalizados con procesos
configurables de clasificación, validación y extracción.
paths:
/v2/verifications/{verification-id}/{entity}:
get:
tags:
- Leer información de la empresa
summary: Obtener sección por ID de verificación
description: >
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 social
- `people`: Personas clave, apoderados y representantes legales
- `documents`: Documentos asociados a la verificación
- `sources`: Fuentes de información (items) que alimentan la
verificación
- `external-lookups`: Evidencia de auditoría de las consultas a fuentes
públicas (SAT, RENAPO, INE, SIGER). Ver [Consultas públicas
externas](/guia-devs/monitorear/consultas-publicas-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](/producto/guias/extracciones-personalizadas) y [Tipos de
ítem personalizados](/producto/guias/tipos-de-item-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](/guia-devs/referencia/coordenadas-citas).
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](/docs/api-reference/leer-información-de-la-empresa-v1/obtener-estatutos-de-las-actas-por-el-id-de-verificacion)
- [Obtener documentos de la empresa por id de verificacion](/docs/api-reference/leer-información-de-la-empresa-v1/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](/docs/api-reference/leer-información-de-la-empresa-v1/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](/docs/api-reference/leer-información-de-la-empresa-v1/obtener-accionistas-de-la-empresa-de-las-actas-por-el-id-de-verificacion)
- [Obtener datos de prevalidacion de documentos](/docs/api-reference/leer-información-de-la-empresa-v1/obtener-datos-de-prevalidacion-de-documentos)
operationId: obtenerSeccionPorIdDeVerificacion
parameters:
- name: id
in: path
required: true
description: ID de la verificación
schema:
type: string
- name: entity
in: path
required: true
description: Sección solicitada
schema:
type: string
enum:
- details
- shareholders
- people
- documents
- sources
- external-lookups
- name: with_citations
in: query
required: false
description: >
Aplica a `people`, `shareholders` y `sources`. Si es `true`:
- Para `people` y `shareholders`: añade `data.citations.url`, una
URL firmada al artifact de coordenadas de esa sección.
- Para `sources`: añade `citations.url` en cada item de tipo acta
dentro de `data.sources`.
Ver [Coordenadas de citas](/guia-devs/referencia/coordenadas-citas).
schema:
type: boolean
default: false
responses:
'200':
description: Sección recuperada exitosamente.
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/V2PublicResponseDetails'
title: Detalles de la empresa
- $ref: '#/components/schemas/V2PublicResponseShareholders'
title: Accionistas
- $ref: '#/components/schemas/V2PublicResponsePeople'
title: Personas
- $ref: '#/components/schemas/V2PublicResponseDocuments'
title: Documentos
- $ref: '#/components/schemas/V2PublicResponseSources'
title: Fuentes
- $ref: '#/components/schemas/V2PublicResponseExternalLookups'
title: Consultas públicas externas
examples:
details:
$ref: '#/components/examples/V2DetailsExample'
shareholders:
$ref: '#/components/examples/V2ShareholdersExample'
people:
$ref: '#/components/examples/V2PeopleExample'
documents:
$ref: '#/components/examples/V2DocumentsExample'
sources:
$ref: '#/components/examples/V2SourcesExample'
external-lookups:
$ref: '#/components/examples/V2ExternalLookupsExample'
'401':
$ref: '#/components/responses/UnauthorizedError'
'404':
$ref: '#/components/responses/NotFoundError'
'500':
$ref: '#/components/responses/InternalServerError'
security:
- ApiKeyAuth: []
components:
schemas:
V2PublicResponseDetails:
type: object
properties:
success:
type: boolean
enum:
- true
data:
$ref: '#/components/schemas/V2DetailsData'
meta:
$ref: '#/components/schemas/V2Meta'
V2PublicResponseShareholders:
type: object
properties:
success:
type: boolean
enum:
- true
data:
$ref: '#/components/schemas/V2ShareholdersData'
meta:
$ref: '#/components/schemas/V2Meta'
V2PublicResponsePeople:
type: object
properties:
success:
type: boolean
enum:
- true
data:
$ref: '#/components/schemas/V2PeopleData'
meta:
$ref: '#/components/schemas/V2Meta'
V2PublicResponseDocuments:
type: object
properties:
success:
type: boolean
enum:
- true
data:
$ref: '#/components/schemas/V2DocumentsData'
meta:
$ref: '#/components/schemas/V2Meta'
V2PublicResponseSources:
type: object
properties:
success:
type: boolean
enum:
- true
data:
$ref: '#/components/schemas/V2SourcesData'
meta:
$ref: '#/components/schemas/V2Meta'
V2PublicResponseExternalLookups:
type: object
properties:
success:
type: boolean
enum:
- true
data:
$ref: '#/components/schemas/V2ExternalLookupsData'
meta:
$ref: '#/components/schemas/V2Meta'
V2DetailsData:
type: object
properties:
verification:
type: object
properties:
id:
type: string
account_id:
type: string
tag:
type: string
nullable: true
created_at:
type: string
comments_legal_review:
type: array
items:
type: string
nullable: true
business_name:
type: object
properties:
value:
type: string
validations:
type: array
items:
$ref: '#/components/schemas/V2PublicValidation'
flow_id:
type: string
nullable: true
onboarding_url:
type: string
documents_status:
type: string
nullable: true
created_by:
type: string
status:
type: string
nullable: true
country:
type: string
tax_id:
type: string
nullable: true
legal:
type: object
properties:
business_name:
$ref: '#/components/schemas/V2PublicFieldValue'
business_type:
$ref: '#/components/schemas/V2PublicFieldValue'
business_folio_number:
$ref: '#/components/schemas/V2PublicFieldValue'
business_duration:
$ref: '#/components/schemas/V2PublicFieldValue'
business_expiry_date:
$ref: '#/components/schemas/V2PublicFieldValue'
business_legal_address:
$ref: '#/components/schemas/V2PublicFieldValue'
business_creditor_ability:
$ref: '#/components/schemas/V2PublicFieldValue'
business_asset_pledging:
$ref: '#/components/schemas/V2PublicFieldValue'
business_guarantor_ability:
$ref: '#/components/schemas/V2PublicFieldValue'
latest_acta_date:
$ref: '#/components/schemas/V2PublicFieldValue'
corporate_purpose:
type: object
properties:
value:
type: object
properties:
full_text:
type: string
summary:
type: string
source:
$ref: '#/components/schemas/V2PublicSource'
registration:
type: object
properties:
has_constitutive:
$ref: '#/components/schemas/V2PublicFieldValue'
business_name:
$ref: '#/components/schemas/V2PublicFieldValue'
acta_number:
$ref: '#/components/schemas/V2PublicFieldValue'
notary_number:
$ref: '#/components/schemas/V2PublicFieldValue'
notary_name:
$ref: '#/components/schemas/V2PublicFieldValue'
business_type:
$ref: '#/components/schemas/V2PublicFieldValue'
folio_number:
$ref: '#/components/schemas/V2PublicFieldValue'
folio_date:
$ref: '#/components/schemas/V2PublicFieldValue'
folio_inscription_date:
$ref: '#/components/schemas/V2PublicFieldValue'
city:
$ref: '#/components/schemas/V2PublicFieldValue'
state:
$ref: '#/components/schemas/V2PublicFieldValue'
registration_date:
$ref: '#/components/schemas/V2PublicFieldValue'
tax:
type: object
properties:
has_constancia:
$ref: '#/components/schemas/V2PublicFieldValue'
business_name:
$ref: '#/components/schemas/V2PublicFieldValue'
business_type:
$ref: '#/components/schemas/V2PublicFieldValue'
business_tax_id:
$ref: '#/components/schemas/V2PublicFieldValue'
business_main_activity:
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/V2PublicCsfBusinessActivity'
source:
$ref: '#/components/schemas/V2PublicSource'
validations:
type: array
items:
$ref: '#/components/schemas/V2PublicValidation'
nullable: true
nullable: true
business_fiscal_status:
$ref: '#/components/schemas/V2PublicFieldValue'
qr_validation:
$ref: '#/components/schemas/V2PublicFieldValue'
business_regime:
$ref: '#/components/schemas/V2PublicFieldValue'
additional_data:
$ref: '#/components/schemas/V2PublicJSONValue'
signatory_validation:
type: object
properties:
full_name:
$ref: '#/components/schemas/V2PublicFieldValue'
paternal_last_name:
$ref: '#/components/schemas/V2PublicFieldValue'
maternal_last_name:
$ref: '#/components/schemas/V2PublicFieldValue'
document_number:
$ref: '#/components/schemas/V2PublicFieldValue'
validation_status:
$ref: '#/components/schemas/V2PublicFieldValue'
validation_value:
$ref: '#/components/schemas/V2PublicFieldValue'
validation_date:
$ref: '#/components/schemas/V2PublicFieldValue'
name_comparison_result:
$ref: '#/components/schemas/V2PublicFieldValue'
id_validation_provider:
$ref: '#/components/schemas/V2PublicJSONValue'
banking:
type: object
properties:
address:
$ref: '#/components/schemas/V2PublicFieldValue'
entity_name:
$ref: '#/components/schemas/V2PublicFieldValue'
document_date:
$ref: '#/components/schemas/V2PublicFieldValue'
document_number:
$ref: '#/components/schemas/V2PublicFieldValue'
additional_data:
$ref: '#/components/schemas/V2PublicJSONValue'
address:
type: object
properties:
business_fiscal_address:
$ref: '#/components/schemas/V2PublicFieldValue'
business_fiscal_address_disaggregated:
$ref: '#/components/schemas/V2PublicJSONValue'
business_comercial_address:
$ref: '#/components/schemas/V2PublicFieldValue'
V2Meta:
type: object
properties:
section:
type: string
enum:
- details
- shareholders
- people
- documents
- sources
- external-lookups
verification:
$ref: '#/components/schemas/V2VerificationMeta'
V2ShareholdersData:
type: object
properties:
shareholders:
type: array
items:
$ref: '#/components/schemas/V2Shareholder'
source:
$ref: '#/components/schemas/V2PublicSource'
nullable: true
capital:
$ref: '#/components/schemas/V2CompanyCapital'
nullable: true
citations:
type: object
description: >
Presente solo cuando se llamó con `?with_citations=true`. Contiene
la URL firmada (CloudFront) al artifact de coordenadas en S3, que
mapea cada field extraído a sus `bounding_boxes` dentro del PDF
original. Ver [Coordenadas de
citas](/guia-devs/referencia/coordenadas-citas).
properties:
url:
type: string
format: uri
description: >
URL firmada y temporal. Descarga el JSON cuanto antes; si
caduca, vuelve a llamar al endpoint con el flag para obtener una
nueva. Si el artifact aún no se horneó para esta verificación,
no se devuelve la llave citations.
example: >-
https://files.gotrebol.com/{verification_id}/citations/shareholders.json?Expires=…&Signature=…
required:
- url
V2PeopleData:
type: object
properties:
key_people:
type: array
items:
$ref: '#/components/schemas/V2KeyPerson'
signatory_groups:
type: object
description: >
Mapa de grupos de roles. Las llaves corresponden a
`V2RoleGroupName`:
"board_members", "executives", "proxies", "auditors".
additionalProperties:
type: array
items:
$ref: '#/components/schemas/V2SignatoryGroupItem'
full_list:
type: array
items:
$ref: '#/components/schemas/V2FullPeopleItem'
citations:
type: object
description: >
Presente solo cuando se llamó con `?with_citations=true`. Contiene
la URL firmada (CloudFront) al artifact de coordenadas en S3, que
mapea cada field extraído a sus `bounding_boxes` dentro del PDF
original. Ver [Coordenadas de
citas](/guia-devs/referencia/coordenadas-citas).
properties:
url:
type: string
format: uri
description: >
URL firmada y temporal. Descarga el JSON cuanto antes; si
caduca, vuelve a llamar al endpoint con el flag para obtener una
nueva. Si el artifact aún no se horneó para esta verificación,
no se devuelve la llave citations.
example: >-
https://files.gotrebol.com/{verification_id}/citations/people.json?Expires=…&Signature=…
required:
- url
V2DocumentsData:
type: object
properties:
documents:
type: array
items:
$ref: '#/components/schemas/V2VerificationDocument'
V2SourcesData:
type: object
properties:
sources:
type: array
items:
$ref: '#/components/schemas/V2CompanySource'
V2ExternalLookupsData:
type: array
description: >-
Arreglo plano de registros de consultas externas, uno por consulta
realizada.
items:
$ref: '#/components/schemas/V2ExternalLookup'
ErrorResponse:
type: object
properties:
success:
type: boolean
example: false
message:
type: string
example: Descripción breve y accionable del error
code:
oneOf:
- type: string
enum:
- VALIDATION_ERROR
- BAD_REQUEST
- UNAUTHORIZED
- FORBIDDEN
- NOT_FOUND
- CONFLICT
- DUPLICATE_RESOURCE
- INTERNAL_SERVER_ERROR
- type: string
description: Código de dominio específico (p.ej., items_not_provided)
example: VALIDATION_ERROR
timestamp:
type: string
format: date-time
example: '2025-01-01T12:34:56.000Z'
V2PublicValidation:
type: object
properties:
cross_check_value:
type: string
cross_check:
type: string
enum:
- match
- no_match
- no_csf
- no_qr
- not_found
item_type:
type: string
custom_message:
type: string
nullable: true
V2PublicFieldValue:
type: object
properties:
value:
oneOf:
- type: string
- type: boolean
source:
$ref: '#/components/schemas/V2PublicSource'
note:
type: string
nullable: true
validations:
type: array
items:
$ref: '#/components/schemas/V2PublicValidation'
nullable: true
nullable: true
V2PublicSource:
type: object
properties:
item_id:
type: number
subject_id:
type: number
nullable: true
item_type:
type: string
document_url:
type: string
format: uri
nullable: true
document_date:
type: string
nullable: true
document_number:
type: string
nullable: true
entity_name:
type: string
nullable: true
extra_fields:
type: object
additionalProperties: true
nullable: true
information_source:
type: string
nullable: true
source_date:
type: string
nullable: true
V2PublicCsfBusinessActivity:
type: object
properties:
order:
type: number
economic_activity:
type: string
percentage:
type: number
date:
type: string
V2PublicJSONValue:
type: object
properties:
value:
type: object
additionalProperties: true
source:
$ref: '#/components/schemas/V2PublicSource'
validations:
type: array
items:
$ref: '#/components/schemas/V2PublicValidation'
nullable: true
nullable: true
V2VerificationMeta:
type: object
properties:
id:
type: string
tag:
type: string
nullable: true
status:
type: string
nullable: true
V2Shareholder:
type: object
properties:
id:
type: number
currency:
type: string
fixed_shares:
type: string
fixed_value:
type: string
id_number:
type: string
id_number_rfc:
type: string
nullable: true
id_type:
type: string
name:
type: string
nationality:
type: string
iso_country_code:
type: string
nullable: true
description: >
Código de país ISO 3166-1 alpha-2 (dos letras) derivado de la
nacionalidad. Ejemplos: "MX" para México, "US" para Estados Unidos,
"PE" para Perú. Este campo convierte el texto de nacionalidad a su
código ISO estándar.
total_shares:
type: string
total_value:
type: string
type:
type: string
variable_shares:
type: string
variable_value:
type: string
share_percentage:
type: number
aml_validated_at:
type: string
nullable: true
aml_validation_status:
type: string
nullable: true
aml_risk_category:
type: array
items:
type: string
aml_data:
type: array
items:
type: object
nullable: true
identity:
$ref: '#/components/schemas/IdentityMatch'
fiscal:
$ref: '#/components/schemas/FiscalMatch'
address:
$ref: '#/components/schemas/AddressMatch'
ubo_forms:
type: object
additionalProperties: true
nullable: true
external_identities:
$ref: '#/components/schemas/PublicExternalIdentities'
nullable: true
gender:
type: string
nullable: true
birth_date:
type: string
nullable: true
birth_entity:
type: string
nullable: true
V2CompanyCapital:
type: object
properties:
fixed_value:
type: string
fixed_shares:
type: string
fixed_value_currency:
type: string
variable_value:
type: string
variable_shares:
type: string
variable_value_currency:
type: string
total_value:
type: string
total_shares:
type: string
total_value_currency:
type: string
V2KeyPerson:
type: object
properties:
names:
type: string
id_number:
type: string
nullable: true
id_number_rfc:
type: string
nullable: true
id_type:
type: string
nullable: true
description: >-
Tipo de identificación utilizado. Los valores posibles son "rfc" o
"curp", si hubo coincidencia, de lo contrario null.
enum:
- rfc
- curp
- null
type:
type: string
nullable: true
description: Tipo de entidad. Los valores posibles son "person" o "business".
enum:
- person
- business
gender:
type: string
nullable: true
nationality:
type: string
nullable: true
description: >
Nacionalidad de la persona. Este campo tomará el valor de los datos
CURP cuando existan (disponible en
`external_identities.curp.applicant_data.nationality`).
iso_country_code:
type: string
nullable: true
description: >
Código de país ISO 3166-1 alpha-2 (dos letras) derivado de la
nacionalidad. Ejemplos: "MX" para México, "US" para Estados Unidos,
"PE" para Perú. Este campo convierte el texto de nacionalidad a su
código ISO estándar.
birth_date:
type: string
nullable: true
birth_entity:
type: string
nullable: true
roles:
type: array
items:
$ref: '#/components/schemas/V2KeyPersonRole'
identity:
$ref: '#/components/schemas/IdentityMatch'
fiscal:
$ref: '#/components/schemas/FiscalMatch'
address:
$ref: '#/components/schemas/AddressMatch'
ubo_forms:
type: object
additionalProperties: true
nullable: true
external_identities:
$ref: '#/components/schemas/PublicExternalIdentities'
nullable: true
people_id:
type: number
ai_suggested:
type: boolean
nullable: true
human_reviewed:
type: boolean
nullable: true
V2SignatoryGroupItem:
type: object
properties:
role_id:
type: string
nullable: true
names:
type: string
id_number:
type: string
id_number_rfc:
type: string
nullable: true
id_type:
type: string
role_name:
type: string
event:
$ref: '#/components/schemas/V2RoleEventName'
duration:
type: number
source:
$ref: '#/components/schemas/V2PublicSource'
type:
type: string
nullable: true
fiscal:
$ref: '#/components/schemas/FiscalMatch'
identity:
$ref: '#/components/schemas/IdentityMatch'
address:
$ref: '#/components/schemas/AddressMatch'
external_identities:
$ref: '#/components/schemas/PublicExternalIdentities'
nullable: true
ubo_forms:
type: object
additionalProperties: true
nullable: true
folio_number:
type: string
nullable: true
folio_date:
type: string
nullable: true
folio_inscription_date:
type: string
nullable: true
iso_country_code:
type: string
nullable: true
description: >
Código de país ISO 3166-1 alpha-2 (dos letras) derivado de la
nacionalidad. Ejemplos: "MX" para México, "US" para Estados Unidos,
"PE" para Perú. Este campo convierte el texto de nacionalidad a su
código ISO estándar.
V2FullPeopleItem:
type: object
properties:
names:
type: string
id_number:
type: string
nullable: true
id_number_rfc:
type: string
nullable: true
id_type:
type: string
nullable: true
description: >-
Tipo de identificación utilizado. Los valores posibles son "rfc" o
"curp" si hubo coincidencia, de lo contrario null.
enum:
- rfc
- curp
- null
type:
type: string
nullable: true
description: Tipo de entidad. Los valores posibles son "person" o "business".
enum:
- person
- business
gender:
type: string
nullable: true
nationality:
type: string
nullable: true
description: >
Nacionalidad de la persona. Este campo tomará el valor de los datos
CURP cuando existan (disponible en
`external_identities.curp.applicant_data.nationality`).
iso_country_code:
type: string
nullable: true
description: >
Código de país ISO 3166-1 alpha-2 (dos letras) derivado de la
nacionalidad. Ejemplos: "MX" para México, "US" para Estados Unidos,
"PE" para Perú. Este campo convierte el texto de nacionalidad a su
código ISO estándar.
birth_date:
type: string
nullable: true
birth_entity:
type: string
nullable: true
identity:
$ref: '#/components/schemas/IdentityMatch'
fiscal:
$ref: '#/components/schemas/FiscalMatch'
address:
$ref: '#/components/schemas/AddressMatch'
ubo_forms:
type: object
additionalProperties: true
nullable: true
external_identities:
$ref: '#/components/schemas/PublicExternalIdentities'
nullable: true
people_id:
type: number
ai_suggested:
type: boolean
nullable: true
human_reviewed:
type: boolean
nullable: true
V2VerificationDocument:
type: object
properties:
url:
type: string
format: uri
nullable: true
created_at:
type: string
nullable: true
item_type:
type: string
nullable: true
hash:
type: string
V2CompanySource:
type: object
properties:
id:
type: number
type:
type: string
entity_name:
type: string
nullable: true
acta_type:
type: string
nullable: true
document_number:
type: string
nullable: true
document_date:
type: string
nullable: true
document_metadata:
type: object
additionalProperties: true
nullable: true
original_file_url:
type: string
format: uri
nullable: true
user_event_completed_at:
type: string
nullable: true
user_event_name:
type: string
nullable: true
invalidated:
type: boolean
options:
type: object
additionalProperties: true
nullable: true
field_confidences:
type: object
additionalProperties: true
nullable: true
validation_result:
type: object
additionalProperties: true
nullable: true
classified_at:
type: string
nullable: true
fme_date:
type: string
nullable: true
fme_folio_number:
type: string
nullable: true
fme_folio_date:
type: string
nullable: true
fme_folio_inscription_date:
type: string
nullable: true
item_value:
type: object
additionalProperties: true
nullable: true
item_status:
type: string
siger_folio_number:
type: string
nullable: true
siger_folio_date:
type: string
nullable: true
siger_folio_inscription_date:
type: string
nullable: true
is_duplicate_item:
type: boolean
nullable: true
notary_name:
type: string
nullable: true
notary_number:
type: string
nullable: true
folio_number:
type: string
nullable: true
folio_date:
type: string
nullable: true
folio_inscription_date:
type: string
nullable: true
notary_state:
type: string
nullable: true
notary_city:
type: string
nullable: true
assembly_minute:
type: object
additionalProperties: true
nullable: true
custom_user_prompts:
type: object
description: >
Resultados de extracciones personalizadas y de procesos de
extracción de tipos de ítem personalizados. Cada clave es el
identificador del procesamiento: el `prompt_id` de la extracción
personalizada, o el `process_reference` del proceso de extracción
del tipo de ítem personalizado. El valor es un objeto JSON acorde al
esquema de la versión activa. Solo aparece cuando hay una extracción
exitosa para ese ítem. Más detalle en las guías [Extracciones
personalizadas](/producto/guias/extracciones-personalizadas) y
[Tipos de ítem
personalizados](/producto/guias/tipos-de-item-personalizados).
additionalProperties: true
nullable: true
citations:
type: object
description: >
Presente solo cuando se llamó con `?with_citations=true` y el ítem
es de tipo acta. Contiene la URL firmada (CloudFront) al artifact de
coordenadas en S3. Ver [Coordenadas de
citas](/guia-devs/referencia/coordenadas-citas).
properties:
url:
type: string
format: uri
description: >
URL firmada y temporal. Descarga el JSON cuanto antes; si
caduca, vuelve a llamar al endpoint con el flag para obtener una
nueva. Si el artifact aún no se horneó para esta verificación,
no se devuelve la llave citations.
example: >-
https://files.gotrebol.com/{verification_id}/citations/sources/{item_id}.json?Expires=…&Signature=…
required:
- url
V2ExternalLookup:
type: object
description: Registro de una consulta realizada a una fuente pública o gubernamental.
properties:
source:
type: string
description: Fuente consultada.
enum:
- sat
- renapo
- ine
- siger
lookup_type:
type: string
description: Tipo de consulta realizada.
enum:
- signature_certificates
- csf_qr_validation
- curp
- lista_nominal
- commercial_registry
agency_name:
type: string
description: Nombre completo de la dependencia consultada.
subject_type:
type: string
description: Sobre quién se realizó la consulta.
enum:
- business
- person
subject_name:
type: string
nullable: true
description: Nombre del sujeto consultado.
subject_identifier:
type: string
nullable: true
description: >-
Identificador enviado a la dependencia: RFC, CURP, clave de elector
o folio mercantil (FME).
queried_at:
type: string
nullable: true
description: >-
Fecha y hora (ISO 8601) de la consulta. null cuando la fuente aún no
expone una fecha confiable.
status:
type: string
description: Resultado de la consulta.
enum:
- success
- not_found
- failed
- pending
- unknown
evidence:
type: array
description: >-
Artefactos de soporte de la consulta (capturas, PDFs o enlaces a la
dependencia).
items:
$ref: '#/components/schemas/V2ExternalLookupEvidence'
data:
type: object
additionalProperties: true
description: >
Datos extraídos de la consulta, específicos de cada fuente y en
snake_case. Ver el detalle por ítem en [Items de consultas públicas
— KYB México](/guia-devs/uso-kyb/mexico/items-consultas-publicas).
IdentityMatch:
type: object
description: Coincidencias con documentos de identidad (INE/Pasaporte)
additionalProperties: true
FiscalMatch:
type: object
description: Coincidencias con CSF (individual)
additionalProperties: true
AddressMatch:
type: object
description: Coincidencias con direcciones de comprobantes/estados de cuenta
additionalProperties: true
PublicExternalIdentities:
type: object
properties:
curp:
$ref: '#/components/schemas/PublicCurpExternalIdentity'
nullable: true
V2KeyPersonRole:
type: object
properties:
id:
type: string
nullable: true
role_name:
type: string
group_name:
$ref: '#/components/schemas/V2RoleGroupName'
event:
$ref: '#/components/schemas/V2RoleEventName'
duration:
type: number
powers:
type: array
items:
type: object
additionalProperties: true
source:
$ref: '#/components/schemas/V2PublicSource'
powers_due_date:
type: string
nullable: true
powers_due_date_source:
type: string
enum:
- legal
- document
nullable: true
V2RoleEventName:
type: string
description: Evento normalizado que originó el rol.
enum:
- addition
- mentioned
- renewal
- removal
V2ExternalLookupEvidence:
type: object
description: Artefacto de soporte de una consulta externa.
properties:
type:
type: string
description: Tipo de evidencia.
enum:
- screenshot
- pdf
- external_link
- trebol_report
url:
type: string
description: >
URL del artefacto. Para `screenshot` y `pdf` es una URL firmada de
corta duración (~1 hora); para `external_link` es la URL pública de
la dependencia.
label:
type: string
nullable: true
description: Descripción legible del artefacto.
generated_at:
type: string
nullable: true
description: Fecha (ISO 8601) en que se produjo el artefacto, si se conoce.
expires_at:
type: string
nullable: true
description: >-
Fecha (ISO 8601) en que expira la URL firmada. null para enlaces
externos o estáticos.
PublicCurpExternalIdentity:
type: object
properties:
search_number:
type: string
nullable: true
description: >
Número de búsqueda utilizado para la consulta CURP. Puede diferir
del CURP retornado en los datos del solicitante.
success:
type: boolean
message:
type: string
nullable: true
applicant_data:
$ref: '#/components/schemas/PublicCurpApplicantData'
nullable: true
evidentiary_document_data:
$ref: '#/components/schemas/PublicCurpEvidentiaryDocumentData'
nullable: true
curp_file:
type: string
nullable: true
description: >
URL firmada al PDF descargado de RENAPO con la constancia del CURP.
La URL incluye un parámetro `Expires=…` y caduca; cuando expire,
vuelve a consultar el endpoint para obtener una URL renovada.
V2RoleGroupName:
type: string
description: Categoría estandarizada del rol.
enum:
- board_members
- executives
- proxies
- auditors
PublicCurpApplicantData:
type: object
properties:
curp:
type: string
names:
type: string
gender:
type: string
birth_date:
type: string
birth_entity:
type: string
nationality:
type: string
first_surname:
type: string
second_surname:
type: string
evidentiary_document:
type: string
PublicCurpEvidentiaryDocumentData:
type: object
properties:
act_number:
type: string
registry_date:
type: string
register_entity:
type: string
register_municipality:
type: string
examples:
V2DetailsExample:
summary: details
value:
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
V2ShareholdersExample:
summary: shareholders
value:
success: true
data:
shareholders:
- id: 1
currency: MXN
fixed_shares: 1000
fixed_value: 100000
id_number: ABC123456
id_type: INE
name: Juan Pérez
nationality: MX
total_shares: 1500
total_value: 150000
type: individual
variable_shares: 500
variable_value: 50000
share_percentage: 60
identity: {}
fiscal: {}
address: {}
capital:
fixed_value: 100000
fixed_shares: 1000
fixed_value_currency: MXN
variable_value: 50000
variable_shares: 500
variable_value_currency: MXN
total_value: 150000
total_shares: 1500
total_value_currency: MXN
source:
item_id: 321
subject_id: null
item_type: ac_mx
document_url: null
document_date: '2024-10-12'
document_number: ACT-123
entity_name: TREBOL OPCO S.A. DE C.V.
extra_fields:
folio_acta_number: ACT-123
folio_number: FN-123
folio_date: '2024-10-12'
folio_inscription_date: '2024-10-20'
notary_number: '112'
notary_name: Lic. Pérez
notary_city: CDMX
notary_state: CDMX
folio_data_source:
folio_number_source: ac_mx
folio_date_source: ac_mx
information_source: acta_constitutiva
source_date: '2024-10-12'
meta:
section: shareholders
verification:
id: c8dc41fc-c477-404e-aff7-b9074f86d6d1
tag: mi-etiqueta
status: pending
V2PeopleExample:
summary: people
value:
success: true
data:
key_people:
- names: RODRIGUEZ MARTINEZ CARLOS ALBERTO
id_number: ROMC850315HDFRRS07
id_type: curp
type: person
gender: HOMBRE
nationality: MEXICO
iso_country_code: MX
birth_date: '1985-03-15'
birth_entity: DISTRITO FEDERAL
roles:
- role_name: apoderado
group_name: proxies
event: addition
duration: 0
powers: []
source:
item_id: 45678
item_type: ac_mx
identity:
person_id:
description: ine_mx - ROMC850315HDFRRS07
address: AV INSURGENTES SUR 1647 COL DEL VALLE BENITO JUAREZ, CDMX
document_date: '2030-06-30'
issued_date: '2022-01-01T00:00:00Z'
due_date: '2032-12-31T00:00:00Z'
extra_fields:
curp: ROMC850315HDFRRS07
rfc: ROMC850315ABC
validations:
- validated_at: '2025-01-15T14:32:45Z'
validation_result: valid_id
source: ine
source:
item_id: 45678
document_url: >-
https://files.sandbox.gotrebol.com/example-verification-id/45678_original_file.pdf?response-content-type=application%2Fpdf&response-content-disposition=inline&Expires=1762987062&Key-Pair-Id=EXAMPLE&Signature=ExampleSignature
item_type: person_id
document_date: '2030-06-30'
document_number: ROMC850315HDFRRS07
entity_name: RODRIGUEZ MARTINEZ CARLOS ALBERTO
extra_fields:
idType: ine_mx
mx_address:
direccion:
pais: México
localidad: ''
codigo_postal: '03100'
tipo_interior: ''
tipo_vialidad: Avenida
nombre_vialidad: Insurgentes Sur
numero_exterior: '1647'
numero_interior: ''
tipo_asentamiento: Colonia
entidad_federativa: Ciudad de México
nombre_asentamiento: Del Valle
municipio_o_ente_territorial: BENITO JUAREZ
explicacion:
- >-
La dirección proporcionada se descompone en varios
componentes según la tabla de estructura de direcciones
en México.
- >-
El tipo de vialidad es 'Avenida', identificado por el
término 'AV'.
- El nombre de la vialidad es 'Insurgentes Sur'.
- El número exterior es '1647'.
- >-
El tipo de asentamiento es 'Colonia', identificado por
el término 'COL'.
- El nombre del asentamiento es 'Del Valle'.
- El municipio es 'BENITO JUAREZ'.
- La entidad federativa es 'Ciudad de México'.
- El código postal es '03100'.
basic_data:
first_name: CARLOS ALBERTO
other_names: ''
first_last_name: RODRIGUEZ
other_last_names: MARTINEZ
fiscal: {}
address: {}
external_identities:
curp:
search_number: ROMC850315HDFRRS07
success: true
message: null
applicant_data:
curp: ROMC850315HDFRRS07
names: CARLOS ALBERTO
gender: HOMBRE
birth_date: '1985-03-15'
birth_entity: DISTRITO FEDERAL
nationality: MEXICO
first_surname: RODRIGUEZ
second_surname: MARTINEZ
evidentiary_document: Acta de nacimiento
evidentiary_document_data:
act_number: '00452'
registry_date: '1985'
register_entity: 09 DISTRITO FEDERAL
register_municipality: 014 BENITO JUAREZ
curp_file: >-
https://files.sandbox.gotrebol.com/mx/curps/ROMC850315HDFRRS07_file.pdf?response-content-type=application%2Fpdf&response-content-disposition=inline&Expires=1762987062&Key-Pair-Id=EXAMPLE&Signature=ExampleSignature
people_id: 5234
ai_suggested: false
human_reviewed: true
signatory_groups: {}
full_list:
- names: RODRIGUEZ MARTINEZ CARLOS ALBERTO
id_number: ROMC850315HDFRRS07
id_type: curp
type: person
gender: HOMBRE
nationality: MEXICO
iso_country_code: MX
birth_date: '1985-03-15'
birth_entity: DISTRITO FEDERAL
identity:
person_id:
description: ine_mx - ROMC850315HDFRRS07
address: AV INSURGENTES SUR 1647 COL DEL VALLE BENITO JUAREZ, CDMX
document_date: '2030-06-30'
extra_fields:
curp: ROMC850315HDFRRS07
rfc: ROMC850315ABC
validations:
- validated_at: '2025-01-15T14:32:45Z'
validation_result: valid_id
source: ine
source:
item_id: 45678
document_url: >-
https://files.sandbox.gotrebol.com/example-verification-id/45678_original_file.pdf?response-content-type=application%2Fpdf&response-content-disposition=inline&Expires=1762987062&Key-Pair-Id=EXAMPLE&Signature=ExampleSignature
item_type: person_id
document_date: '2030-06-30'
document_number: ROMC850315HDFRRS07
entity_name: RODRIGUEZ MARTINEZ CARLOS ALBERTO
extra_fields:
idType: ine_mx
mx_address:
direccion:
pais: México
localidad: ''
codigo_postal: '03100'
tipo_interior: ''
tipo_vialidad: Avenida
nombre_vialidad: Insurgentes Sur
numero_exterior: '1647'
numero_interior: ''
tipo_asentamiento: Colonia
entidad_federativa: Ciudad de México
nombre_asentamiento: Del Valle
municipio_o_ente_territorial: BENITO JUAREZ
explicacion:
- >-
La dirección proporcionada se descompone en varios
componentes según la tabla de estructura de direcciones
en México.
- >-
El tipo de vialidad es 'Avenida', identificado por el
término 'AV'.
- El nombre de la vialidad es 'Insurgentes Sur'.
- El número exterior es '1647'.
- >-
El tipo de asentamiento es 'Colonia', identificado por
el término 'COL'.
- El nombre del asentamiento es 'Del Valle'.
- El municipio es 'BENITO JUAREZ'.
- La entidad federativa es 'Ciudad de México'.
- El código postal es '03100'.
basic_data:
first_name: CARLOS ALBERTO
other_names: ''
first_last_name: RODRIGUEZ
other_last_names: MARTINEZ
fiscal: {}
address: {}
external_identities:
curp:
search_number: ROMC850315HDFRRS07
success: true
message: null
applicant_data:
curp: ROMC850315HDFRRS07
names: CARLOS ALBERTO
gender: HOMBRE
birth_date: '1985-03-15'
birth_entity: DISTRITO FEDERAL
nationality: MEXICO
first_surname: RODRIGUEZ
second_surname: MARTINEZ
evidentiary_document: Acta de nacimiento
evidentiary_document_data:
act_number: '00452'
registry_date: '1985'
register_entity: 09 DISTRITO FEDERAL
register_municipality: 014 BENITO JUAREZ
curp_file: >-
https://files.sandbox.gotrebol.com/mx/curps/ROMC850315HDFRRS07_file.pdf?response-content-type=application%2Fpdf&response-content-disposition=inline&Expires=1762987062&Key-Pair-Id=EXAMPLE&Signature=ExampleSignature
people_id: 5234
ai_suggested: false
human_reviewed: true
meta:
section: people
verification:
id: c8dc41fc-c477-404e-aff7-b9074f86d6d1
tag: mi-etiqueta
status: pending
V2DocumentsExample:
summary: documents
value:
success: true
data:
documents:
- url: https://files.gotrebol.com/.../original.pdf
created_at: '2024-11-01T10:00:00.000Z'
item_type: csf_mx
hash: a3f2...
meta:
section: documents
verification:
id: c8dc41fc-c477-404e-aff7-b9074f86d6d1
tag: mi-etiqueta
status: pending
V2SourcesExample:
summary: sources
value:
success: true
data:
sources:
- id: 25440
type: ac_mx
entity_name: TREBOL OPCO S.A. DE C.V.
document_number: ACT-123
document_date: '2024-10-12'
original_file_url: https://files.gotrebol.com/.../original.pdf
user_event_completed_at: '2024-11-01T10:00:00.000Z'
user_event_name: upload_document
invalidated: false
classified_at: '2024-11-01T10:00:00.000Z'
item_status: complete
notary_name: Lic. Pérez
notary_number: '112'
folio_number: FN-123
folio_date: '2024-10-12'
folio_inscription_date: '2024-10-20'
notary_state: CDMX
notary_city: CDMX
custom_user_prompts:
mi_procesamiento_acta:
campo_ejemplo: valor extraído
meta:
section: sources
verification:
id: c8dc41fc-c477-404e-aff7-b9074f86d6d1
tag: mi-etiqueta
status: pending
V2ExternalLookupsExample:
summary: external-lookups
value:
success: true
data:
- source: sat
lookup_type: signature_certificates
agency_name: Servicio de Administración Tributaria (SAT)
subject_type: business
subject_name: EMPRESA EJEMPLO SA DE CV
subject_identifier: ABC123456789
queried_at: '2026-06-16T18:25:00.000Z'
status: success
evidence:
- type: screenshot
url: https://files.gotrebol.com/.../sat-screenshot.jpg?...firma...
label: SAT certificate lookup screenshot
generated_at: '2026-06-16T18:25:00.000Z'
expires_at: '2026-06-16T19:25:00.000Z'
data:
tax_id: ABC123456789
legal_name: EMPRESA EJEMPLO SA DE CV
business_type: SOCIEDAD ANONIMA DE CAPITAL VARIABLE
certificates:
- serial_number: '00001000000700333012'
status: Activo
type: SELLO
start_date: '2023-01-01T00:00:00.000Z'
end_date: '2027-12-31T23:59:59.000Z'
legal_representative_rfc: REP123456EF1
person_email: null
- source: sat
lookup_type: csf_qr_validation
agency_name: Servicio de Administración Tributaria (SAT)
subject_type: business
subject_name: EMPRESA EJEMPLO SA DE CV
subject_identifier: ABC123456789
queried_at: '2026-06-16T18:22:00.000Z'
status: success
evidence:
- type: external_link
url: >-
https://siat.sat.gob.mx/app/qr/faces/pages/mobile/validadorqr.jsf?D1=10&D2=1&D3=...
label: SAT CSF QR validator
generated_at: null
expires_at: null
data:
validation_result: VALID
validation_status: completed
validation_message: Constancia válida y vigente.
constancia_type: moral
- source: renapo
lookup_type: curp
agency_name: Registro Nacional de Población (RENAPO)
subject_type: person
subject_name: Juan Carlos Pérez García
subject_identifier: PERE800101HDFXXX01
queried_at: null
status: success
evidence:
- type: pdf
url: https://files.gotrebol.com/.../renapo-curp.pdf?...firma...
label: RENAPO CURP certificate
generated_at: null
expires_at: '2026-06-16T19:25:00.000Z'
data:
curp: PERE800101HDFXXX01
curp_status: alta_normal
names: Juan Carlos
first_surname: Pérez
second_surname: García
- source: ine
lookup_type: lista_nominal
agency_name: Instituto Nacional Electoral (INE)
subject_type: person
subject_name: Juan Carlos Pérez García
subject_identifier: PEREJC80010112H300
queried_at: '2026-06-16T18:20:00.000Z'
status: success
evidence: []
data:
validation_message: Credencial válida y vigente en lista nominal.
- source: siger
lookup_type: commercial_registry
agency_name: Sistema Integral de Gestión Registral (SIGER)
subject_type: business
subject_name: EMPRESA EJEMPLO SA DE CV
subject_identifier: N-2024038395
queried_at: '2026-06-16T18:15:00.000Z'
status: success
evidence: []
data:
legal_name: EMPRESA EJEMPLO SA DE CV
fme_number: N-2024038395
fme_status: Activo
federal_entity: Ciudad de México
meta:
section: external-lookups
verification:
id: c8dc41fc-c477-404e-aff7-b9074f86d6d1
tag: mi-etiqueta
status: finished
responses:
UnauthorizedError:
description: No autorizado
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
Unauthorized:
summary: Falta API key o inválida
value:
success: false
message: Unauthorized
code: UNAUTHORIZED
timestamp: '2025-01-01T12:34:56.000Z'
NotFoundError:
description: Recurso no encontrado
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
NotFound:
summary: Recurso inexistente
value:
success: false
message: Entity not found
code: NOT_FOUND
timestamp: '2025-01-01T12:34:56.000Z'
InternalServerError:
description: Error interno del servidor
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
ServerError:
summary: Error inesperado
value:
success: false
message: Internal server error
code: INTERNAL_SERVER_ERROR
timestamp: '2025-01-01T12:34:56.000Z'
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
````