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

# Obtener todas las sesiones

> Este endpoint, dado un ID de poll, devuelve los metadatos de todas las sesiones de manera paginada. Por defecto, trae los primeros 1000 registros del año actual. Se pueden usar parámetros opcionales para controlar el rango de fechas y la paginación.



## OpenAPI

````yaml open-api-files/treble-api-es.json GET /devapi/poll/{poll_id}/sessions
openapi: 3.0.1
info:
  title: API de Treble Poll
  description: Documentación para el endpoint de despliegue de polls en Treble
  version: 1.0.0
servers:
  - url: https://main.treble.ai
    description: Servidor principal de Treble
  - url: https://tudominio.com
    description: >-
      Servidor de ejemplo para implementar los webhooks. Esto representa TU
      servidor donde debes implementar los endpoints que Treble llamará.
security: []
tags:
  - name: Webhooks
    description: >-
      Endpoints que Treble llamará en tu servidor. Estos no son endpoints reales
      que puedas llamar, sino una representación de los webhooks que Treble
      invocará en tu sistema.
paths:
  /devapi/poll/{poll_id}/sessions:
    get:
      summary: Obtener metadatos de sesiones de un poll
      description: >-
        Este endpoint, dado un ID de poll, devuelve los metadatos de todas las
        sesiones de manera paginada. Por defecto, trae los primeros 1000
        registros del año actual. Se pueden usar parámetros opcionales para
        controlar el rango de fechas y la paginación.
      parameters:
        - name: poll_id
          in: path
          required: true
          description: ID del poll del cual se quieren obtener las sesiones
          schema:
            type: string
        - name: Authorization
          in: header
          required: true
          description: >-
            API Key de autorización. Se puede obtener en
            https://app.treble.ai/en/dashboard/settings/developers
          schema:
            type: string
          example: API_KEY
        - name: since
          in: query
          required: false
          description: Timestamp UNIX UTC para la fecha de inicio del rango a consultar
          schema:
            type: integer
        - name: until
          in: query
          required: false
          description: Timestamp UNIX UTC para la fecha final del rango a consultar
          schema:
            type: integer
        - name: limit
          in: query
          required: false
          description: >-
            Número entero entre 1 y 10.000 que indica la cantidad de sesiones a
            recuperar
          schema:
            type: integer
            minimum: 1
            maximum: 10000
        - name: after
          in: query
          required: false
          description: >-
            Cursor de paginación devuelto en la propiedad 'next_id' de la
            respuesta anterior
          schema:
            type: string
      responses:
        '200':
          description: Lista de metadatos de sesiones obtenida correctamente
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: ID único de la sesión
                        created_at:
                          type: string
                          format: date-time
                          description: Fecha y hora en que se creó la sesión
                        finished_at:
                          type: string
                          format: date-time
                          description: Fecha y hora en que finalizó la sesión
                        user:
                          type: object
                          properties:
                            country_code:
                              type: string
                              description: Código de país del usuario
                            cellphone:
                              type: string
                              description: >-
                                Número de teléfono del usuario sin el código de
                                país
                    description: Lista de metadatos de sesiones
                  next_id:
                    type: string
                    description: Cursor para obtener la siguiente página de resultados
              example:
                results:
                  - id: dabcf6c0-8150-4231-bafd-a3c331da385f4
                    created_at: '2022-03-09 17:00:28.956422'
                    finished_at: '2022-03-09 19:08:38.808986'
                    user:
                      country_code: '+57'
                      cellphone: '987654321'
                  - id: dabcf6c0-8850-4231-bafd-a3c331da385f9
                    created_at: '2022-03-09 17:11:46.754945'
                    finished_at: '2022-03-09 19:18:41.401605'
                    user:
                      country_code: '+57'
                      cellphone: '123456789'
                next_id: da848b5f-27e2-49f9-8d31-313b791daf8d
        '401':
          description: No autorizado. API Key inválida o faltante.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Código de error
                  message:
                    type: string
                    description: Descripción del error
        '404':
          description: Poll no encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Código de error
                  message:
                    type: string
                    description: Descripción del error

````