Ottieni lo stato di consegna di più messaggi

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

Returns the delivery status of multiple messages in a single call, which is significantly more efficient than calling the single-status endpoint in a loop. All IDs supplied in a single request must belong to the same channel (SMS, RCS, or WHATSAPP). If you need to check messages across different channels, make one batch request per channel. Supply the customerMessageId values as a comma-separated string in the ids query parameter (for example: ids=msg-001,msg-002,msg-003). Do not include spaces between IDs. While there is no strict hard limit on the number of IDs, it is recommended to keep each batch under a few hundred IDs to avoid excessively long query strings and potential HTTP 414 URI Too Long errors from intermediary proxies or load balancers. For very large lookups, split the IDs into multiple requests. The response is an unordered list of DeliveryStatoResponse objects. Important: IDs that do not match any known message for the authenticated company and specified channel are silently omitted from the results. This means the response array may contain fewer entries than the number of IDs you supplied. If none of the IDs match, you will receive an empty array (HTTP 200 with an empty JSON list), not a 404. To detect missing messages, compare the returned customerMessageId values against your original list. Each entry in the response contains the same fields as the single-status endpoint, including deliveryStato (DELIVERED, SENT, RECEIVED, ERROR, EXPIRED, UNKNOWN) and deliveryStatoDescription for human-readable details. Error responses: 500 indicates an unexpected server-side error; retry the request after a short delay. For single-message lookups, use GET /partner-gateway/v1/messages/status/{customerMessageId} instead. For a full historical view with pagination and date filtering, see GET /partner-gateway/v1/messages/history.

Richiesta

Risposte

200

Lista delle voci sullo stato di consegna (può essere vuota se nessuna trovata)

500

Errore interno del server