- v2 (Recomendado)
- v1 (Legacy)
Obtener sección v2 por ID de verificación
GET/v2/verifications/{id}/{entity}Este es el endpoint recomendado. Los endpoints v1 están disponibles en el tab “v1 (Legacy)” pero se recomienda migrar a v2.
entity.ID de la verificación
Sección solicitada. Valores permitidos:
details- Detalles de la empresashareholders- Accionistaspeople- Apoderados y representantes legalesdocuments- Documentos de la empresasources- Fuentes de pre-evaluación de documentos
Copy
Ask AI
curl -X GET "https://api.gotrebol.com/v2/verifications/{id}/details" \
-H "x-api-key: YOUR_API_KEY"
Copy
Ask AI
{
"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",
"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"
}
}
}
}
}
Indica si la solicitud fue exitosa
Contiene los datos de la sección solicitada. La estructura varía según el valor de
entity.Este endpoint consolida la funcionalidad de los siguientes endpoints v1:
GET /verifications/{id}/detailsGET /verifications/{id}/shareholdersGET /verifications/{id}/peopleGET /verifications/{id}/documentsGET /verifications/{id}/sources
Estos endpoints están en modo legacy. Se recomienda migrar al endpoint v2 unificado que consolida toda esta funcionalidad.
GET /verifications/{verification-id}/details
GET /verifications/{verification-id}/details
Obtener estatutos de las actas por el ID de VerificaciónObtener información detallada sobre los estatutos e información fiscal de la empresa usando el id de la verificación.
El ID único de la verificación
Copy
Ask AI
curl -X GET "https://api.gotrebol.com/verifications/{verification-id}/details" \
-H "x-api-key: YOUR_API_KEY"
Copy
Ask AI
{
"fields": {
"business_name": {
"value": "TREBOL OPCO S.A. DE C.V."
},
"tax_id": {
"value": "SAG160927GIA"
}
},
"verification": {
"id": "c8dc41fc-c477-404e-aff7-b9074f86d6d1",
"tag": "etiqueta",
"status": "pending"
}
}
Migración a v2: Usa
GET /v2/verifications/{id}/details con entity=detailsGET /verifications/{verification-id}/documents
GET /verifications/{verification-id}/documents
Obtener documentos de la empresa por id de verificacionObtener documentos relacionados con una verificación específica usando el id de la verificación.
El ID de la verificación
Copy
Ask AI
curl -X GET "https://api.gotrebol.com/verifications/{verification-id}/documents" \
-H "x-api-key: YOUR_API_KEY"
Copy
Ask AI
{
"documents": [
{
"label": "Constancia de situación fiscal",
"url": "https://..."
},
{
"label": "Acta constitutiva",
"url": "https://..."
}
],
"verification": {
"id": "c8dc41fc-c477-404e-aff7-b9074f86d6d1",
"tag": "etiqueta",
"status": "pending"
}
}
Migración a v2: Usa
GET /v2/verifications/{id}/documents con entity=documentsGET /verifications/{verification-id}/people
GET /verifications/{verification-id}/people
Obtener apoderados y representantes legales de la empresa de las actas por el ID de VerificaciónObtener la lista de apoderados y representantes legales de la empresa usando el id de la verificación.
El ID de la verificación
Copy
Ask AI
curl -X GET "https://api.gotrebol.com/verifications/{verification-id}/people" \
-H "x-api-key: YOUR_API_KEY"
Copy
Ask AI
{
"data": {
"key_people": [
{
"names": "Juan Pérez",
"role": "apoderado"
}
],
"full_list": [
{
"names": "Juan Pérez",
"role": "apoderado"
}
],
"board_members": [
{
"name": "Ana López",
"event": "addition"
}
]
},
"verification": {
"id": "c8dc41fc-c477-404e-aff7-b9074f86d6d1",
"tag": "etiqueta",
"status": "pending"
}
}
Migración a v2: Usa
GET /v2/verifications/{id}/people con entity=peopleGET /verifications/{verification-id}/shareholders
GET /verifications/{verification-id}/shareholders
Obtener accionistas de la empresa de las actas por el ID de VerificaciónObtener la lista de accionistas asociados con una empresa usando el id de la verificación.
El ID de la verificación
Copy
Ask AI
curl -X GET "https://api.gotrebol.com/verifications/{verification-id}/shareholders" \
-H "x-api-key: YOUR_API_KEY"
Copy
Ask AI
{
"shareholders": [
{
"name": "ACME LLC",
"share_percentage": 60
},
{
"name": "Juan Pérez",
"share_percentage": 40
}
],
"capital": {
"total_value": 1000000,
"currency": "MXN"
},
"source": {
"document": "acta_constitutiva"
},
"verification": {
"id": "c8dc41fc-c477-404e-aff7-b9074f86d6d1",
"tag": "etiqueta",
"status": "pending"
}
}
Migración a v2: Usa
GET /v2/verifications/{id}/shareholders con entity=shareholdersGET /verifications/{verification-id}/sources
GET /verifications/{verification-id}/sources
Obtener datos de prevalidación de documentosObtener fuentes para la pre-evaluación de documentos relacionados con una empresa usando el id de la verificación.
El ID de la verificación
Copy
Ask AI
curl -X GET "https://api.gotrebol.com/verifications/{verification-id}/sources" \
-H "x-api-key: YOUR_API_KEY"
Copy
Ask AI
{
"data": [
{
"type": "csf_mx",
"label": "Constancia SAT",
"item_id": 123,
"status": "complete"
}
],
"verification": {
"id": "c8dc41fc-c477-404e-aff7-b9074f86d6d1",
"tag": "etiqueta",
"status": "pending"
}
}
Migración a v2: Usa
GET /v2/verifications/{id}/sources con entity=sourcesGET /verifications/{id}
GET /verifications/{id}
Obtener una verificación por su IDRetorna una verificación pública con sus items serializados.
El ID único de la verificación
Copy
Ask AI
curl -X GET "https://api.gotrebol.com/verifications/{id}" \
-H "x-api-key: YOUR_API_KEY"
Copy
Ask AI
{
"id": "c8dc41fc-c477-404e-aff7-b9074f86d6d1",
"account_id": "99999999-9999-9999-9999-999999999999",
"status": "pending",
"created_at": "2025-04-28T20:10:06.840Z",
"updated_at": "2025-04-28T20:10:06.840Z",
"tag": "etiqueta",
"tax_id": "SAG160927GIA",
"business_name": "Trebol OPCO",
"flow_id": "documents-v2",
"details_url": "https://app.gotrebol.com/verifications/c8dc41fc-c477-404e-aff7-b9074f86d6d1",
"onboarding_url": "https://onboarding.gotrebol.com/verification/c8dc41fc...",
"items": [
{
"id": 25440,
"item_status": "pending",
"item_type": "csf_mx",
"item_value": {}
}
]
}
Este endpoint sigue disponible en v1 y no tiene equivalente directo en v2, ya que v2 se enfoca en secciones específicas.