> ## 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 apoderados y representates legales de la empresa de las actas por el ID de Verificacion > Obtener la lista de apoderados y representates legales de la empresa usando el id de la verificación. ## OpenAPI ````yaml /api-reference/openapi.yaml get /verifications/{verification-id}/people 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: /verifications/{verification-id}/people: get: tags: - Leer información de la empresa v1 summary: >- Obtener apoderados y representates legales de la empresa de las actas por el ID de Verificacion description: >- Obtener la lista de apoderados y representates legales de la empresa usando el id de la verificación. parameters: - in: path name: verification-id required: true description: El ID de la verificación. schema: type: string responses: '200': description: Signatarios de la verificación recuperados exitosamente. content: application/json: schema: $ref: '#/components/schemas/CompanyPeopleResponse' examples: Success: summary: Respuesta exitosa value: 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 '401': $ref: '#/components/responses/UnauthorizedError' '404': $ref: '#/components/responses/NotFoundError' '500': $ref: '#/components/responses/InternalServerError' security: - ApiKeyAuth: [] components: schemas: CompanyPeopleResponse: type: object properties: data: type: object properties: key_people: type: array description: Personas clave (con roles y poderes) items: $ref: '#/components/schemas/KeyPeopleItem' full_list: type: array description: Personas detectadas sin agrupar por rol items: $ref: '#/components/schemas/PeopleItem' proxies: type: array description: Grupo dinámico de apoderados detectados en actas items: $ref: '#/components/schemas/SignatoryGroupItem' auditors: type: array description: Grupo dinámico de auditores detectados en actas items: $ref: '#/components/schemas/SignatoryGroupItem' board_members: type: array description: Grupo dinámico de miembros del consejo detectados en actas items: $ref: '#/components/schemas/SignatoryGroupItem' additionalProperties: type: array items: $ref: '#/components/schemas/SignatoryGroupItem' verification: $ref: '#/components/schemas/VerificationSummary' KeyPeopleItem: type: object properties: names: type: string idNumber: type: string nullable: true id_number_rfc: type: string nullable: true gender: type: string nullable: true nationality: type: string nullable: true birthDate: type: string nullable: true birthEntity: type: string nullable: true roles: type: array items: $ref: '#/components/schemas/KeyPeopleRole' identity: $ref: '#/components/schemas/IdentityMatch' fiscal: $ref: '#/components/schemas/FiscalMatch' address: $ref: '#/components/schemas/AddressMatch' ubo_forms: type: object additionalProperties: true nullable: true externalIdentities: type: object additionalProperties: true nullable: true scope: type: array items: type: string nullable: true peopleId: type: number ai_suggested: type: boolean nullable: true human_reviewed: type: boolean nullable: true PeopleItem: type: object properties: names: type: string idNumber: type: string nullable: true id_number_rfc: type: string nullable: true gender: type: string nullable: true nationality: type: string nullable: true birthDate: type: string nullable: true birthEntity: 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 externalIdentities: type: object additionalProperties: true nullable: true scope: type: array items: type: string nullable: true peopleId: type: number ai_suggested: type: boolean nullable: true human_reviewed: type: boolean nullable: true SignatoryGroupItem: type: object properties: roleId: type: string nullable: true names: type: string idNumber: type: string id_number_rfc: type: string nullable: true idType: type: string roleName: type: string event: type: string duration: type: number sourceLines: type: array items: type: string source: $ref: '#/components/schemas/SourceInfo' type: type: string nullable: true fiscal: type: object additionalProperties: true identity: type: object additionalProperties: true address: type: object additionalProperties: true externalIdentities: type: object additionalProperties: true nullable: true ubo_forms: type: object additionalProperties: true nullable: true folioNumber: type: string nullable: true folioDate: type: string nullable: true folioInscriptionDate: type: string nullable: true VerificationSummary: type: object properties: id: type: string description: ID de la verificación. tag: type: string description: Etiqueta de la verificación. status: type: string description: Estado de la verificación. required: - id - tag - status 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' KeyPeopleRole: type: object properties: role_name: type: string group_name: type: string event: type: string duration: type: number powers: type: array items: $ref: '#/components/schemas/RolePower' sourceLines: type: array items: type: string source: $ref: '#/components/schemas/SourceInfo' powers_source: $ref: '#/components/schemas/SourceInfo' nullable: true powers_due_date: type: string format: date-time nullable: true powers_due_date_source: type: string enum: - legal - document nullable: true 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 SourceInfo: type: object properties: itemId: type: number subjectId: type: number nullable: true documentUrl: type: string format: uri nullable: true itemType: type: string documentDate: type: string nullable: true documentNumber: type: string nullable: true entityName: type: string nullable: true extraFields: type: object properties: notaryCity: type: string nullable: true notaryState: type: string nullable: true notaryName: type: string nullable: true notaryNumber: type: string nullable: true folioNumber: type: string nullable: true folioDate: type: string nullable: true folioInscriptionDate: type: string nullable: true folioDataSource: type: string nullable: true RolePower: type: object properties: power_name: type: string duration: type: number has_power: type: boolean signature_type: type: string nullable: true has_limits: type: boolean limits_description: type: string due_date: type: string format: date-time nullable: true due_date_source: type: string enum: - legal - document nullable: true 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 ````