> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tupana.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar conexiones

> Las empresas conectadas a tu integración. Es también el paso "empresa emisora" de cualquier flujo: cada conexión trae el giro, su código y la dirección, así que no necesitas guardarlos — mandas `company_id` y la API completa el emisor.

Las empresas conectadas a tu integración. Una conexión es lo único que tu SaaS
conoce de una empresa: nunca ves la clave del SII, porque la entrega el usuario
final dentro de [Tupana Link](/api-reference/v2/connect/tupana-link).

Es además el paso **empresa emisora** de cualquier flujo. Cada conexión trae el
giro, su código y la dirección, así que no necesitas guardarlos: mandas
`company_id` al emitir y la API completa el emisor.

## Buscar

`?search=` filtra por nombre o RUT, con un mínimo de 2 caracteres — con una
letra, "buscar" sería traer todo. Menos de 2 responde `400`.

```bash theme={null}
curl https://api.tupana.ai/v2/connections/?search=arquitectura \
  -H "Authorization: Api-Key TU_API_KEY"
```

## Paginar

`limit` viene en 25 y se acota a 100. El `total` va aparte del largo de `data`
a propósito: si tienes más conexiones de las que pediste, te enteras en vez de
recibir un corte silencioso.

## Estado

`status` es `active` mientras la conexión sirve, y `requires_action` cuando la
clave dejó de funcionar. En ese caso no hay nada que reintentar desde tu lado:
el usuario final tiene que reconectar la empresa con Tupana Link.


## OpenAPI

````yaml api-reference/openapi-v2.json GET /connections/
openapi: 3.0.0
info:
  title: Tupana API — v2
  description: >-
    API v2 de Tupana: facturación electrónica, cesiones, recaudación, consultas,
    boleta de honorarios y nómina. Los identificadores de recursos son public
    IDs opacos con prefijo (docu_, ment_, cred_, doce_, empl_…).
  version: 2.0.0
servers:
  - url: https://api.tupana.ai/v2
    description: Producción (v2)
security:
  - apiKeyAuth: []
paths:
  /connections/:
    get:
      tags:
        - Conexiones
      summary: Listar conexiones
      description: >-
        Las empresas conectadas a tu integración. Es también el paso "empresa
        emisora" de cualquier flujo: cada conexión trae el giro, su código y la
        dirección, así que no necesitas guardarlos — mandas `company_id` y la
        API completa el emisor.
      operationId: listConnections_v2
      parameters:
        - name: search
          in: query
          required: false
          schema:
            type: string
            minLength: 2
          description: Filtra por nombre o RUT. Mínimo 2 caracteres.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 25
            minimum: 1
            maximum: 100
          description: Conexiones por página. Se acota a 100.
      responses:
        '200':
          description: Conexiones del integrador
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        connection_id:
                          type: string
                          example: cred_2959001189629508554
                        company_id:
                          type: string
                          example: ment_3672486436546233854
                        provider:
                          type: string
                          example: sii
                        type:
                          type: string
                          example: tax
                        name:
                          type: string
                          example: 1 A 1 ARQUITECTURA Y CONSTRUCCIÓN SPA
                        tax_id:
                          type: string
                          example: 77.918.412-9
                        environment:
                          type: string
                          enum:
                            - sandbox
                            - production
                        status:
                          type: string
                          enum:
                            - active
                            - requires_action
                          description: >-
                            `requires_action`: la clave dejó de servir y el
                            usuario final tiene que reconectar.
                        last_verified_at:
                          type: string
                          format: date-time
                        business_activity:
                          type: string
                          description: Giro del emisor, tal como lo necesita el documento.
                        activity_code:
                          type: integer
                          nullable: true
                        address:
                          type: string
                        district:
                          type: string
                        city:
                          type: string
                  total:
                    type: integer
                    description: >-
                      Cuántas conexiones hay en total. Va aparte del largo de
                      `data` para que un corte por `limit` nunca pase
                      inadvertido.
                  limit:
                    type: integer
        '400':
          description: La búsqueda trae menos de 2 caracteres
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        API Key para autenticación. Debe proporcionarse en el header
        Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo
        'Api-Key ' seguido de tu API key)

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.