Elenca storico invii

GET 
/api/partner-gateway/v1/messages/history

Returns a paginated list of sent messages for the given channel and date range, allowing you to browse your complete sending history with flexible filtering. Use this endpoint when you need to review past sends, audit delivery performance over a time window, or build dashboards and reports on message delivery rates. The channel parameter is required and restricts results to a single messaging channel (SMS, RCS, or WHATSAPP). To retrieve history across multiple channels, make separate requests for each channel. The from and to parameters define the send-date range (inclusive on both ends) and are required. They must be valid ISO-8601 OffsetDateTime strings that include the timezone offset, for example: 2025-01-01T00:00:00+01:00 or 2025-06-15T23:59:59Z. Common formatting mistakes to avoid: omitting the timezone offset (2025-01-01T00:00:00 alone is not valid), using date-only strings without a time component, or using non-ISO separators. If from is after to, the result will be an empty list rather than an error. The optional status parameter lets you filter by a specific delivery status such as DELIVERED, SENT, ERROR, EXPIRED, or UNKNOWN. Omit this parameter to return messages in all statuses. Pagination is controlled by the page and limit parameters. Pages are 0-based (the first page is page=0). The default page size is 20 if limit is not specified. To iterate through all results, increment the page parameter until the response returns fewer items than the requested limit, which indicates you have reached the last page. The response is a JSON array of DeliveryStatoResponse objects, which may be empty if no messages match the given filters. For large date ranges with many messages, consider using the export endpoint (POST /partner-gateway/v1/messages/history/export) to generate a downloadable CSV file instead of paginating through thousands of results. Error responses: 500 indicates an unexpected server-side error; retry after a short delay.

Richiesta

Risposte

200

Lista dei messaggi inviati (può essere vuota)

500

Errore interno del server