> ## 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.

# Obter todas as sessões

> Este endpoint, dado um ID de poll, retorna os metadados de todas as sessões de forma paginada. Por padrão, traz os primeiros 1000 registros do ano atual. Parâmetros opcionais podem ser usados para controlar o intervalo de datas e a paginação.



## OpenAPI

````yaml open-api-files/treble-api-pt.json GET /devapi/poll/{poll_id}/sessions
openapi: 3.0.1
info:
  title: API do Treble Poll
  description: Documentação para o endpoint de implantação de polls no Treble
  version: 1.0.0
servers:
  - url: https://main.treble.ai
    description: Servidor principal do Treble
  - url: https://seudominio.com
    description: >-
      Servidor de exemplo para implementar os webhooks. Isso representa SEU
      servidor onde você deve implementar os endpoints que o Treble chamará.
security: []
tags:
  - name: Webhooks
    description: >-
      Endpoints que o Treble chamará no seu servidor. Estes não são endpoints
      reais que você possa chamar, mas uma representação dos webhooks que o
      Treble invocará no seu sistema.
paths:
  /devapi/poll/{poll_id}/sessions:
    get:
      summary: Obter metadados de sessões de um poll
      description: >-
        Este endpoint, dado um ID de poll, retorna os metadados de todas as
        sessões de forma paginada. Por padrão, traz os primeiros 1000 registros
        do ano atual. Parâmetros opcionais podem ser usados para controlar o
        intervalo de datas e a paginação.
      parameters:
        - name: poll_id
          in: path
          required: true
          description: ID do poll do qual você deseja obter as sessões
          schema:
            type: string
        - name: Authorization
          in: header
          required: true
          description: >-
            Chave API de autorização. Pode ser obtida em
            https://app.treble.ai/en/dashboard/settings
          schema:
            type: string
          example: API_KEY
        - name: since
          in: query
          required: false
          description: Timestamp UNIX UTC para a data de início do intervalo a consultar
          schema:
            type: integer
        - name: until
          in: query
          required: false
          description: Timestamp UNIX UTC para a data final do intervalo a consultar
          schema:
            type: integer
        - name: limit
          in: query
          required: false
          description: >-
            Número inteiro entre 1 e 10.000 que indica a quantidade de sessões a
            recuperar
          schema:
            type: integer
            minimum: 1
            maximum: 10000
        - name: after
          in: query
          required: false
          description: >-
            Cursor de paginação retornado na propriedade 'next_id' da resposta
            anterior
          schema:
            type: string
      responses:
        '200':
          description: Lista de metadados de sessões obtida corretamente
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: ID único da sessão
                        created_at:
                          type: string
                          format: date-time
                          description: Data e hora em que a sessão foi criada
                        finished_at:
                          type: string
                          format: date-time
                          description: Data e hora em que a sessão foi finalizada
                        user:
                          type: object
                          properties:
                            country_code:
                              type: string
                              description: Código do país do usuário
                            cellphone:
                              type: string
                              description: >-
                                Número de telefone do usuário sem o código do
                                país
                    description: Lista de metadados de sessões
                  next_id:
                    type: string
                    description: Cursor para obter a próxima 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: Não autorizado. Chave API inválida ou ausente.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Código de erro
                  message:
                    type: string
                    description: Descrição do erro
        '404':
          description: Poll não encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Código de erro
                  message:
                    type: string
                    description: Descrição do erro

````