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

# Recupero Esiti Messaggi per Periodo

> Questo endpoint consente di ottenere, per un cliente identificato tramite la propria API key, l’elenco degli esiti di tutti i messaggi presi in carico (basandosi sul campo `completion_date`) all’interno di un intervallo temporale specificato. Per ogni messaggio, l’API restituisce il suo ID, lo stato e, in caso di fallimento, la ragione (contenuta nel campo `resp_message`). <Note>Assicurati che le date siano passate esattamente nel formato richiesto, con uno spazio tra la data e l'orario (eventualmente codificato come %20 nell'URL). I limite di risposta e di 1000 risultati</Note>



## OpenAPI

````yaml GET /api/messages/statusByPeriod
openapi: 3.1.0
info:
  title: Trilly API
  description: Trilly APIs
  version: 1.0.0
servers:
  - url: https://backend.trilly.chat
security: []
paths:
  /api/messages/statusByPeriod:
    get:
      summary: Recupero degli Esiti dei Messaggi per Periodo
      description: >-
        Questo endpoint consente di ottenere, per un cliente identificato
        tramite la propria API key, l’elenco degli esiti di tutti i messaggi
        presi in carico (basandosi sul campo `completion_date`) all’interno di
        un intervallo temporale specificato. Per ogni messaggio, l’API
        restituisce il suo ID, lo stato e, in caso di fallimento, la ragione
        (contenuta nel campo `resp_message`). <Note>Assicurati che le date siano
        passate esattamente nel formato richiesto, con uno spazio tra la data e
        l'orario (eventualmente codificato come %20 nell'URL). I limite di
        risposta e di 1000 risultati</Note>
      parameters:
        - name: api_key
          in: query
          required: true
          schema:
            type: string
          description: La chiave API del cliente autenticato.
        - name: start
          in: query
          required: true
          schema:
            type: string
            example: 01/10/2025 14:11
          description: >-
            Data e ora di inizio del periodo. Il formato richiesto è 'dd/mm/YYYY
            HH:i' (es. '01/10/2025 14: 11').
        - name: end
          in: query
          required: true
          schema:
            type: string
            example: 01/10/2025 15:00
          description: >-
            Data e ora di fine del periodo. Il formato richiesto è 'dd/mm/YYYY
            HH:i' (es. '01/10/2025 15: 00').
      responses:
        '200':
          description: Elenco degli esiti dei messaggi inviati nel periodo specificato.
          content:
            application/json:
              schema:
                type: object
                properties:
                  messages:
                    type: array
                    items:
                      type: object
                      properties:
                        message_id:
                          type: integer
                          description: ID del messaggio.
                        status:
                          type: string
                          description: Esito del messaggio.
                        reason:
                          type:
                            - string
                            - 'null'
                          description: Motivo del fallimento.
              example:
                messages:
                  - message_id: 25058
                    status: FAILED
                    reason: Sessione non connessa
                  - message_id: 25059
                    status: SENT
                    reason: null

````