Export a compressed CSV report of audience-level delivery and engagement data for a specific message. This includes sent, delivered, clicked, failed, and unsubscribed events across Push, Email, and SMS channels.
id
of the message you want to export. You can retrieve this via the Create Message or View Messages APIs.
After you make this request, you will likely get a 200 OK
response with a csv_file_url
.
Example successful response:
404
with the following error:
.csv.gz
file before starting a new export.csv_file_url
. If the file is ready, it will download. If not, retry after some delay.
external_user_id
— Maps to the External ID. See Users.subscription_id
— Maps to the Subscription ID. See Subscriptions.device_type
— The platform/channel the Subscription is for.sent
— Timestamp of when the message was sent.delivered
— Timestamp of confirmed delivery. See Confirmed Delivery.clicked
— Timestamp of click event (if any).onesignal_id
— Maps to the internal OneSignal User ID.failed
— Timestamp of delivery failure.unsubscribed
— Timestamp of unsubscription event.failure_message
— Description of the failure, if any. See Push message reports.Your App API key with prefix Key
. See Keys & IDs.
The identifier of the message in UUID v4 format. Get this id
in the response of your Create Message API request, the View Messages API, and in your OneSignal dashboard Message Reports.
Your OneSignal App ID in UUID v4 format. See Keys & IDs.
200
The response is of type object
.