> ## 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 estatutos de las actas por la Etiqueta

> Obtener información detallada de los estatutos e información fiscal sobre una empresa específica usando su etiqueta.



## OpenAPI

````yaml /api-reference/openapi.yaml get /companies/{etiqueta}/details
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:
  /companies/{etiqueta}/details:
    get:
      tags:
        - Leer información de la empresa v1
      summary: Obtener estatutos de las actas por la Etiqueta
      description: >-
        Obtener información detallada de los estatutos e información fiscal
        sobre una empresa específica usando su etiqueta.
      parameters:
        - $ref: '#/components/parameters/etiquetaParam'
      responses:
        '200':
          description: Detalles de la empresa recuperados exitosamente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyDetailsResponse'
              examples:
                Success:
                  summary: Respuesta exitosa
                  value:
                    fields:
                      business_name:
                        value: TREBOL OPCO S.A. DE C.V.
                        businessType: company
                        sourceLines:
                          - 'Acta #123'
                          - SIGER
                      tax_id:
                        value: SAG160927GIA
                    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:
  parameters:
    etiquetaParam:
      name: etiqueta
      in: path
      required: true
      description: La etiqueta única que identifica la empresa dentro de tu sistema interno
      schema:
        type: string
  schemas:
    CompanyDetailsResponse:
      type: object
      properties:
        fields:
          $ref: '#/components/schemas/CompanyDetailsFields'
        verification:
          $ref: '#/components/schemas/VerificationSummary'
    CompanyDetailsFields:
      type: object
      properties:
        businessName:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        businessConstitutiveData:
          $ref: '#/components/schemas/CompanyDetailsFieldConstitutive'
          nullable: true
        businessType:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        businessRegistrationDate:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        businessDuration:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        businessFiscalStatus:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        businessTaxId:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        businessAddress:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        businessComercialAddress:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        businessFiscalAddress:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        businessFiscalAddressDisaggregated:
          $ref: '#/components/schemas/CompanyDetailsFieldAddressDisaggregated'
          nullable: true
        businessLegalAddress:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        businessCreditorAbility:
          $ref: '#/components/schemas/CompanyDetailsFieldBoolean'
          nullable: true
        businessAssetPledging:
          $ref: '#/components/schemas/CompanyDetailsFieldBoolean'
          nullable: true
        businessGuarantorAbility:
          $ref: '#/components/schemas/CompanyDetailsFieldBoolean'
          nullable: true
        businessPurposeCreditLimit:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        businessMainActivity:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        businessRequiresLegalReview:
          $ref: '#/components/schemas/CompanyDetailsFieldBoolean'
          nullable: true
        businessFolioNumber:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        businessDocuments:
          $ref: '#/components/schemas/CompanyDetailsFieldDocuments'
          nullable: true
        pfaeName:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        pfaeTaxId:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        pfaeType:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        pfaeFiscalStatus:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        pfaeRegistrationDate:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        pfaeAddress:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        pfaeMainActivity:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        pfaeComercialAddress:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        pfaeFiscalAddress:
          $ref: '#/components/schemas/CompanyDetailsFieldString'
          nullable: true
        pfaeDocuments:
          $ref: '#/components/schemas/CompanyDetailsFieldDocuments'
          nullable: true
        pfaeIdentity:
          $ref: '#/components/schemas/CompanyDetailsFieldPfaeIdentity'
          nullable: true
        sigerValidation:
          $ref: '#/components/schemas/CompanyDetailsFieldSigerValidation'
          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'
    CompanyDetailsFieldString:
      allOf:
        - $ref: '#/components/schemas/CompanyDetailsField'
        - type: object
          properties:
            value:
              type: string
    CompanyDetailsFieldConstitutive:
      allOf:
        - $ref: '#/components/schemas/CompanyDetailsField'
        - type: object
          properties:
            value:
              $ref: '#/components/schemas/CompanyConstitutiveData'
    CompanyDetailsFieldAddressDisaggregated:
      allOf:
        - $ref: '#/components/schemas/CompanyDetailsField'
        - type: object
          properties:
            value:
              $ref: '#/components/schemas/AddressDisaggregated'
    CompanyDetailsFieldBoolean:
      allOf:
        - $ref: '#/components/schemas/CompanyDetailsField'
        - type: object
          properties:
            value:
              type: boolean
    CompanyDetailsFieldDocuments:
      allOf:
        - $ref: '#/components/schemas/CompanyDetailsField'
        - type: object
          properties:
            value:
              type: array
              items:
                $ref: '#/components/schemas/DocumentProps'
    CompanyDetailsFieldPfaeIdentity:
      allOf:
        - $ref: '#/components/schemas/CompanyDetailsField'
        - type: object
          properties:
            value:
              $ref: '#/components/schemas/PfaeIdentity'
    CompanyDetailsFieldSigerValidation:
      allOf:
        - $ref: '#/components/schemas/CompanyDetailsField'
        - type: object
          properties:
            value:
              $ref: '#/components/schemas/SigerValidationValue'
    CompanyDetailsField:
      type: object
      properties:
        value:
          description: >-
            Valor extraído para el campo. Puede ser string, number, booleano u
            objeto con estructura específica.
          oneOf:
            - type: string
            - type: number
            - type: boolean
            - type: object
            - type: array
        businessType:
          type: string
          nullable: true
        sourceLines:
          type: array
          items:
            type: string
          nullable: true
        validation:
          type: object
          nullable: true
      nullable: true
    CompanyConstitutiveData:
      type: object
      properties:
        constitutiveBusinessName:
          type: string
        constitutiveActaNumber:
          type: string
        constitutiveNotaryNumber:
          type: string
        constitutiveNotaryName:
          type: string
        constitutiveBusinessType:
          type: string
        constitutiveFolioNumber:
          type: string
        constitutiveFolioDate:
          type: string
        constitutiveFolioInscriptionDate:
          type: string
    AddressDisaggregated:
      type: object
      properties:
        street_type:
          type: string
        street_name:
          type: string
        external_number:
          type: string
        internal_number:
          type: string
        neighborhood:
          type: string
        district:
          type: string
        state:
          type: string
        post_code:
          type: string
    DocumentProps:
      type: object
      properties:
        documentType:
          type: string
        enterpriseName:
          type: string
          nullable: true
        matchesEnterpriseName:
          type: boolean
          nullable: true
        documentNumber:
          type: string
          nullable: true
        documentDate:
          type: string
          format: date-time
          nullable: true
        notaryPlace:
          type: string
          nullable: true
        notaryNumber:
          type: string
          nullable: true
        notaryName:
          type: string
          nullable: true
        state:
          type: string
        idType:
          type: string
          nullable: true
        documentUrl:
          type: string
          format: uri
          nullable: true
        isDuplicated:
          type: boolean
          nullable: true
        isIncomplete:
          type: boolean
          nullable: true
        itemId:
          type: number
    PfaeIdentity:
      type: object
      properties:
        claveElector:
          type: string
          nullable: true
        dueDate:
          type: string
          format: date-time
          nullable: true
        curp:
          type: string
          nullable: true
        nacionalidad:
          type: string
          nullable: true
    SigerValidationValue:
      type: object
      properties:
        folioNumberMatch:
          type: string
          nullable: true
        mostRecentActaUploaded:
          type: boolean
        sigerValue:
          type: object
          description: Objeto SIGER serializado
  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

````