{ "info": { "_postman_id": "212445fb-ee92-438d-865b-df30b1563479", "name": "Twilio SendGrid Marketing Campaigns Statistics API", "description": "The Marketing Campaigns Stats API allows you to retrieve statistics for both Automations and Single Sends. The statistics provided include bounces, clicks, opens, and more. You can export stats in CSV format for use in other applications. You can also retrieve Marketing Campaigns stats in the [Marketing Campaigns application user interface](https://mc.sendgrid.com/).\n\nThis API provides statistics for Marketing Campaigns only. For stats related to event tracking, please see the [Stats API](https://docs.sendgrid.com/api-reference/stats).\n\nContact Support:\n Name: Twilio SendGrid Support", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "lastUpdatedBy": "35240", "uid": "35240-212445fb-ee92-438d-865b-df30b1563479" }, "item": [ { "name": "v3", "item": [ { "name": "marketing", "item": [ { "name": "stats", "item": [ { "name": "automations", "item": [ { "name": "{id}", "item": [ { "name": "links", "item": [ { "name": "Get Automation Click Tracking Stats by ID", "id": "4279cc7c-8ae7-4376-8ddf-45804c31d653", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/automations/:id/links?group_by=step_id,step_id&step_ids=,&page_size=25&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "automations", ":id", "links" ], "query": [ { "description": "Automations can have multiple steps. Including `step_id` as a `group_by` metric allows further granularity of stats.", "key": "group_by", "value": "step_id,step_id" }, { "description": "Comma-separated list of `step_ids` that you want the link stats for.", "key": "step_ids", "value": "," }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" } ], "variable": [ { "id": "f27fd7e7-304a-4573-b9f8-0a7804936a77", "key": "id", "value": "", "description": "(Required) The ID of the Automation you want to get click tracking stats for. " } ] }, "description": "**This endpoint lets you retrieve click-tracking stats for a single Automation**.\n\nThe stats returned list the URLs embedded in your Automation and the number of clicks each one received." }, "response": [ { "id": "f1a8d4a8-fe9d-4a62-8fb4-cdf8f512a2c3", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/automations/:id/links?group_by=step_id,step_id&step_ids=,&page_size=25&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "automations", ":id", "links" ], "query": [ { "description": "Automations can have multiple steps. Including `step_id` as a `group_by` metric allows further granularity of stats.", "key": "group_by", "value": "step_id,step_id" }, { "description": "Comma-separated list of `step_ids` that you want the link stats for.", "key": "step_ids", "value": "," }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"results\": [\n {\n \"url\": \"\",\n \"step_id\": \"\",\n \"clicks\": \"\",\n \"url_location\": \"\"\n },\n {\n \"url\": \"\",\n \"step_id\": \"\",\n \"clicks\": \"\",\n \"url_location\": \"\"\n }\n ],\n \"total_clicks\": \"\",\n \"_metadata\": {\n \"prev\": \"\",\n \"self\": \"\",\n \"next\": \"\",\n \"count\": \"\"\n }\n}", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-f1a8d4a8-fe9d-4a62-8fb4-cdf8f512a2c3" }, { "id": "015741b4-dac8-46db-9910-0059f0879063", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/automations/:id/links?group_by=step_id,step_id&step_ids=,&page_size=25&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "automations", ":id", "links" ], "query": [ { "description": "Automations can have multiple steps. Including `step_id` as a `group_by` metric allows further granularity of stats.", "key": "group_by", "value": "step_id,step_id" }, { "description": "Comma-separated list of `step_ids` that you want the link stats for.", "key": "step_ids", "value": "," }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-015741b4-dac8-46db-9910-0059f0879063" }, { "id": "15338385-c8bb-42be-bc2b-989b9e693dff", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/automations/:id/links?group_by=step_id,step_id&step_ids=,&page_size=25&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "automations", ":id", "links" ], "query": [ { "description": "Automations can have multiple steps. Including `step_id` as a `group_by` metric allows further granularity of stats.", "key": "group_by", "value": "step_id,step_id" }, { "description": "Comma-separated list of `step_ids` that you want the link stats for.", "key": "step_ids", "value": "," }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-15338385-c8bb-42be-bc2b-989b9e693dff" } ], "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-4279cc7c-8ae7-4376-8ddf-45804c31d653" } ], "id": "796822fd-ce64-4999-89f5-0557508a8b01", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-796822fd-ce64-4999-89f5-0557508a8b01" }, { "name": "Get Automation Stats by ID", "id": "b4912f1a-e41c-41df-bbd6-22b75b033893", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/automations/:id?group_by=step_id,step_id&step_ids=,&aggregated_by=day&start_date=2021-01-01&end_date=2021-12-31&timezone=UTC&page_size=25&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "automations", ":id" ], "query": [ { "description": "Automations can have multiple steps. Including `step_id` as a `group_by` metric allows further granularity of stats.", "key": "group_by", "value": "step_id,step_id" }, { "description": "Comma-separated list of `step_ids` that you want the link stats for.", "key": "step_ids", "value": "," }, { "description": "Dictates how the stats are time-sliced. Currently, `\"total\"` and `\"day\"` are supported.", "key": "aggregated_by", "value": "day" }, { "description": "Format: `YYYY-MM-DD`. If this parameter is included, the stats' start date is included in the search.", "key": "start_date", "value": "2021-01-01" }, { "description": "Format: `YYYY-MM-DD`.If this parameter is included, the stats' end date is included in the search.", "key": "end_date", "value": "2021-12-31" }, { "description": "[IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented, e.g., \"America/Chicago\".", "key": "timezone", "value": "UTC" }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" } ], "variable": [ { "id": "7be2444a-de6f-4720-93dc-e1d3e8b7c077", "key": "id", "value": "", "description": "(Required) The ID of the Automation for which you want to retrieve statistics. " } ] }, "description": "**This endpoint allows you to retrieve stats for a single Automation using its ID.**\n\nMultiple Automation IDs can be retrieved using the \"Get All Automation Stats\" endpoint. Once you have an ID, this endpoint will return detailed stats for the single automation specified.\n\nYou may constrain the stats returned using the `start_date` and `end_date` query string parameters. You can also use the `group_by` and `aggregated_by` query string parameters to further refine the stats returned." }, "response": [ { "id": "60f5e555-a87b-4f6f-9783-6f551428ae44", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/automations/:id?group_by=step_id,step_id&step_ids=,&aggregated_by=day&start_date=2021-01-01&end_date=2021-12-31&timezone=UTC&page_size=25&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "automations", ":id" ], "query": [ { "description": "Automations can have multiple steps. Including `step_id` as a `group_by` metric allows further granularity of stats.", "key": "group_by", "value": "step_id,step_id" }, { "description": "Comma-separated list of `step_ids` that you want the link stats for.", "key": "step_ids", "value": "," }, { "description": "Dictates how the stats are time-sliced. Currently, `\"total\"` and `\"day\"` are supported.", "key": "aggregated_by", "value": "day" }, { "description": "Format: `YYYY-MM-DD`. If this parameter is included, the stats' start date is included in the search.", "key": "start_date", "value": "2021-01-01" }, { "description": "Format: `YYYY-MM-DD`.If this parameter is included, the stats' end date is included in the search.", "key": "end_date", "value": "2021-12-31" }, { "description": "[IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented, e.g., \"America/Chicago\".", "key": "timezone", "value": "UTC" }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"results\": [\n {\n \"id\": \"\",\n \"aggregation\": \"total\",\n \"step_id\": \"all\",\n \"stats\": {\n \"bounce_drops\": \"\",\n \"bounces\": \"\",\n \"clicks\": \"\",\n \"delivered\": \"\",\n \"invalid_emails\": \"\",\n \"opens\": \"\",\n \"requests\": \"\",\n \"spam_report_drops\": \"\",\n \"spam_reports\": \"\",\n \"unique_clicks\": \"\",\n \"unique_opens\": \"\",\n \"unsubscribes\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"aggregation\": \"total\",\n \"step_id\": \"all\",\n \"stats\": {\n \"bounce_drops\": \"\",\n \"bounces\": \"\",\n \"clicks\": \"\",\n \"delivered\": \"\",\n \"invalid_emails\": \"\",\n \"opens\": \"\",\n \"requests\": \"\",\n \"spam_report_drops\": \"\",\n \"spam_reports\": \"\",\n \"unique_clicks\": \"\",\n \"unique_opens\": \"\",\n \"unsubscribes\": \"\"\n }\n }\n ],\n \"_metadata\": {\n \"prev\": \"\",\n \"self\": \"\",\n \"next\": \"\",\n \"count\": \"\"\n }\n}", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-60f5e555-a87b-4f6f-9783-6f551428ae44" }, { "id": "b0147f68-df6a-4558-82f2-42551b103878", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/automations/:id?group_by=step_id,step_id&step_ids=,&aggregated_by=day&start_date=2021-01-01&end_date=2021-12-31&timezone=UTC&page_size=25&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "automations", ":id" ], "query": [ { "description": "Automations can have multiple steps. Including `step_id` as a `group_by` metric allows further granularity of stats.", "key": "group_by", "value": "step_id,step_id" }, { "description": "Comma-separated list of `step_ids` that you want the link stats for.", "key": "step_ids", "value": "," }, { "description": "Dictates how the stats are time-sliced. Currently, `\"total\"` and `\"day\"` are supported.", "key": "aggregated_by", "value": "day" }, { "description": "Format: `YYYY-MM-DD`. If this parameter is included, the stats' start date is included in the search.", "key": "start_date", "value": "2021-01-01" }, { "description": "Format: `YYYY-MM-DD`.If this parameter is included, the stats' end date is included in the search.", "key": "end_date", "value": "2021-12-31" }, { "description": "[IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented, e.g., \"America/Chicago\".", "key": "timezone", "value": "UTC" }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-b0147f68-df6a-4558-82f2-42551b103878" }, { "id": "95596c61-c1f2-435c-a4f1-321d80e8a7bd", "name": "response", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/automations/:id?group_by=step_id,step_id&step_ids=,&aggregated_by=day&start_date=2021-01-01&end_date=2021-12-31&timezone=UTC&page_size=25&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "automations", ":id" ], "query": [ { "description": "Automations can have multiple steps. Including `step_id` as a `group_by` metric allows further granularity of stats.", "key": "group_by", "value": "step_id,step_id" }, { "description": "Comma-separated list of `step_ids` that you want the link stats for.", "key": "step_ids", "value": "," }, { "description": "Dictates how the stats are time-sliced. Currently, `\"total\"` and `\"day\"` are supported.", "key": "aggregated_by", "value": "day" }, { "description": "Format: `YYYY-MM-DD`. If this parameter is included, the stats' start date is included in the search.", "key": "start_date", "value": "2021-01-01" }, { "description": "Format: `YYYY-MM-DD`.If this parameter is included, the stats' end date is included in the search.", "key": "end_date", "value": "2021-12-31" }, { "description": "[IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented, e.g., \"America/Chicago\".", "key": "timezone", "value": "UTC" }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-95596c61-c1f2-435c-a4f1-321d80e8a7bd" } ], "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-b4912f1a-e41c-41df-bbd6-22b75b033893" } ], "id": "f3deaffe-8c32-40d9-ae78-ba5aa2cdbcdd", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-f3deaffe-8c32-40d9-ae78-ba5aa2cdbcdd" }, { "name": "export", "item": [ { "name": "Export Single Send Stats", "id": "614e44bd-d64e-4c07-b1ae-3d82c5335508", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/automations/export?ids=&timezone=UTC", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "automations", "export" ], "query": [ { "description": "The IDs of Single Sends for which to export stats.", "key": "ids", "value": "" }, { "description": "The [IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented; i.e. `\"America/Chicago\"`. This parameter changes the timezone format only; it does not alter which stats are returned.", "key": "timezone", "value": "UTC" } ] }, "description": "**This endpoint allows you to export Single Send stats as .CSV data**.\n\nYou can specify one Single Send or many: include as many Single Send IDs as you need, separating them with commas, as the value of the `ids` query string parameter.\n\nThe data is returned as plain text response but in .CSV format, so your application making the call can present the information in whatever way is most appropriate, or just save the data as a .csv file." }, "response": [ { "id": "bbf99b86-62bd-4fd2-8083-fb84f8c7a7f4", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/automations/export?ids=&timezone=UTC", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "automations", "export" ], "query": [ { "description": "The IDs of Single Sends for which to export stats.", "key": "ids", "value": "" }, { "description": "The [IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented; i.e. `\"America/Chicago\"`. This parameter changes the timezone format only; it does not alter which stats are returned.", "key": "timezone", "value": "UTC" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-bbf99b86-62bd-4fd2-8083-fb84f8c7a7f4" }, { "id": "edee0a33-46fd-4f54-9411-83c8dbfc4bc8", "name": "response", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/automations/export?ids=&timezone=UTC", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "automations", "export" ], "query": [ { "description": "The IDs of Single Sends for which to export stats.", "key": "ids", "value": "" }, { "description": "The [IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented; i.e. `\"America/Chicago\"`. This parameter changes the timezone format only; it does not alter which stats are returned.", "key": "timezone", "value": "UTC" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-edee0a33-46fd-4f54-9411-83c8dbfc4bc8" } ], "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-614e44bd-d64e-4c07-b1ae-3d82c5335508" } ], "id": "faa30153-002d-49af-8756-03a73dfd2eaa", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-faa30153-002d-49af-8756-03a73dfd2eaa" }, { "name": "Get All Automation Stats", "id": "32b39f3a-42db-4d35-87a2-a7a9acde79bf", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/automations?automation_ids=&page_size=25&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "automations" ], "query": [ { "description": "This endpoint returns all automation IDs if no `automation_ids` are specified.", "key": "automation_ids", "value": "" }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" } ] }, "description": "**This endpoint allows you to retrieve stats for all your Automations.**\n\nBy default, all of your Automations will be returned, but you can specify a selection by passing in a comma-separated list of Automation IDs as the value of the query string parameter `automation_ids`.\n\nResponses are paginated. You can limit the number of responses returned per batch using the `page_size` query string parameter. The default is 25, but you can specify a value between 1 and 50.\n\nYou can retrieve a specific page of responses with the `page_token` query string parameter." }, "response": [ { "id": "aed5cfd3-6ed6-41ac-8941-b895600e0656", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/automations?automation_ids=&page_size=25&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "automations" ], "query": [ { "description": "This endpoint returns all automation IDs if no `automation_ids` are specified.", "key": "automation_ids", "value": "" }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"results\": [\n {\n \"id\": \"\",\n \"aggregation\": \"total\",\n \"step_id\": \"all\",\n \"stats\": {\n \"bounce_drops\": \"\",\n \"bounces\": \"\",\n \"clicks\": \"\",\n \"delivered\": \"\",\n \"invalid_emails\": \"\",\n \"opens\": \"\",\n \"requests\": \"\",\n \"spam_report_drops\": \"\",\n \"spam_reports\": \"\",\n \"unique_clicks\": \"\",\n \"unique_opens\": \"\",\n \"unsubscribes\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"aggregation\": \"total\",\n \"step_id\": \"all\",\n \"stats\": {\n \"bounce_drops\": \"\",\n \"bounces\": \"\",\n \"clicks\": \"\",\n \"delivered\": \"\",\n \"invalid_emails\": \"\",\n \"opens\": \"\",\n \"requests\": \"\",\n \"spam_report_drops\": \"\",\n \"spam_reports\": \"\",\n \"unique_clicks\": \"\",\n \"unique_opens\": \"\",\n \"unsubscribes\": \"\"\n }\n }\n ],\n \"_metadata\": {\n \"prev\": \"\",\n \"self\": \"\",\n \"next\": \"\",\n \"count\": \"\"\n }\n}", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-aed5cfd3-6ed6-41ac-8941-b895600e0656" }, { "id": "e5e82cf8-aa7d-4b3b-9ae8-35749f758172", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/automations?automation_ids=&page_size=25&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "automations" ], "query": [ { "description": "This endpoint returns all automation IDs if no `automation_ids` are specified.", "key": "automation_ids", "value": "" }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-e5e82cf8-aa7d-4b3b-9ae8-35749f758172" } ], "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-32b39f3a-42db-4d35-87a2-a7a9acde79bf" } ], "id": "4c97f164-e7f9-425d-b24c-5b8c8df6381f", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-4c97f164-e7f9-425d-b24c-5b8c8df6381f" }, { "name": "singlesends", "item": [ { "name": "{id}", "item": [ { "name": "links", "item": [ { "name": "Get Single Send Click Tracking Stats by ID", "id": "be1cad92-10e2-4c18-800f-9330b9267929", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/singlesends/:id/links?page_size=25&page_token=&group_by=ab_variation,ab_phase&ab_variation_id=&ab_phase_id=send", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "singlesends", ":id", "links" ], "query": [ { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" }, { "description": "A/B Single Sends have multiple variation IDs and phase IDs. Including these additional fields allows further granularity of stats by these fields.", "key": "group_by", "value": "ab_variation,ab_phase" }, { "key": "ab_variation_id", "value": "" }, { "key": "ab_phase_id", "value": "send" } ], "variable": [ { "id": "a9f6842e-d4db-4f57-b47b-c217aac3e193", "key": "id", "value": "", "description": "(Required) The ID of Single Send for which you want to retrieve link stats." } ] }, "description": "**This endpoint lets you retrieve click-tracking stats for one Single Send**.\n\nThe stats returned list the URLs embedded in the specified Single Send and the number of clicks each one received." }, "response": [ { "id": "16e85e5f-77f6-4d41-a460-404b79076d0c", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/singlesends/:id/links?page_size=25&page_token=&group_by=ab_variation,ab_phase&ab_variation_id=&ab_phase_id=send", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "singlesends", ":id", "links" ], "query": [ { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" }, { "description": "A/B Single Sends have multiple variation IDs and phase IDs. Including these additional fields allows further granularity of stats by these fields.", "key": "group_by", "value": "ab_variation,ab_phase" }, { "key": "ab_variation_id", "value": "" }, { "key": "ab_phase_id", "value": "send" } ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"results\": [\n {\n \"url\": \"\",\n \"ab_variation\": \"\",\n \"ab_phase\": \"all\",\n \"clicks\": \"\",\n \"url_location\": \"\"\n },\n {\n \"url\": \"\",\n \"ab_variation\": \"\",\n \"ab_phase\": \"test\",\n \"clicks\": \"\",\n \"url_location\": \"\"\n }\n ],\n \"_metadata\": {\n \"prev\": \"\",\n \"self\": \"\",\n \"next\": \"\",\n \"count\": \"\"\n },\n \"total_clicks\": \"\"\n}", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-16e85e5f-77f6-4d41-a460-404b79076d0c" }, { "id": "f06f4ba4-d904-42c0-8bef-300678eb21c1", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/singlesends/:id/links?page_size=25&page_token=&group_by=ab_variation,ab_phase&ab_variation_id=&ab_phase_id=send", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "singlesends", ":id", "links" ], "query": [ { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" }, { "description": "A/B Single Sends have multiple variation IDs and phase IDs. Including these additional fields allows further granularity of stats by these fields.", "key": "group_by", "value": "ab_variation,ab_phase" }, { "key": "ab_variation_id", "value": "" }, { "key": "ab_phase_id", "value": "send" } ], "variable": [ { "key": "id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-f06f4ba4-d904-42c0-8bef-300678eb21c1" }, { "id": "65edfafc-0e85-4747-a8d7-75c8c9dab2d0", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/singlesends/:id/links?page_size=25&page_token=&group_by=ab_variation,ab_phase&ab_variation_id=&ab_phase_id=send", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "singlesends", ":id", "links" ], "query": [ { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" }, { "description": "A/B Single Sends have multiple variation IDs and phase IDs. Including these additional fields allows further granularity of stats by these fields.", "key": "group_by", "value": "ab_variation,ab_phase" }, { "key": "ab_variation_id", "value": "" }, { "key": "ab_phase_id", "value": "send" } ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-65edfafc-0e85-4747-a8d7-75c8c9dab2d0" } ], "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-be1cad92-10e2-4c18-800f-9330b9267929" } ], "id": "b04d3e0b-5a2f-4825-8eec-786db352f68c", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-b04d3e0b-5a2f-4825-8eec-786db352f68c" }, { "name": "Get Single Send Stats by ID", "id": "9b4e48be-18ed-4904-947b-b8fc44fbdaa9", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/singlesends/:id?aggregated_by=day&start_date=2021-01-01&end_date=2021-12-31&timezone=UTC&page_size=25&page_token=&group_by=ab_variation,ab_phase", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "singlesends", ":id" ], "query": [ { "description": "Dictates how the stats are time-sliced. Currently, `\"total\"` and `\"day\"` are supported.", "key": "aggregated_by", "value": "day" }, { "description": "Format: `YYYY-MM-DD`. If this parameter is included, the stats' start date is included in the search.", "key": "start_date", "value": "2021-01-01" }, { "description": "Format: `YYYY-MM-DD`.If this parameter is included, the stats' end date is included in the search.", "key": "end_date", "value": "2021-12-31" }, { "description": "[IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented, e.g., \"America/Chicago\".", "key": "timezone", "value": "UTC" }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" }, { "description": "A/B Single Sends have multiple variation IDs and phase IDs. Including these additional fields allows further granularity of stats by these fields.", "key": "group_by", "value": "ab_variation,ab_phase" } ], "variable": [ { "id": "8516a913-4c3c-46ef-9126-c6e6ff8f7859", "key": "id", "value": "", "description": "(Required) The ID of Single Send for which you want to retrieve stats." } ] }, "description": "**This endpoint allows you to retrieve stats for an individual Single Send using a Single Send ID.**\n\nMultiple Single Send IDs can be retrieved using the \"Get All Single Sends Stats\" endpoint. Once you have an ID, this endpoint will return detailed stats for the Single Send specified.\n\nYou may constrain the stats returned using the `start_date` and `end_date` query string parameters. You can also use the `group_by` and `aggregated_by` query string parameters to further refine the stats returned." }, "response": [ { "id": "0675a9bb-7f82-4bf5-b5eb-1a3da525e8a9", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/singlesends/:id?aggregated_by=day&start_date=2021-01-01&end_date=2021-12-31&timezone=UTC&page_size=25&page_token=&group_by=ab_variation,ab_phase", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "singlesends", ":id" ], "query": [ { "description": "Dictates how the stats are time-sliced. Currently, `\"total\"` and `\"day\"` are supported.", "key": "aggregated_by", "value": "day" }, { "description": "Format: `YYYY-MM-DD`. If this parameter is included, the stats' start date is included in the search.", "key": "start_date", "value": "2021-01-01" }, { "description": "Format: `YYYY-MM-DD`.If this parameter is included, the stats' end date is included in the search.", "key": "end_date", "value": "2021-12-31" }, { "description": "[IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented, e.g., \"America/Chicago\".", "key": "timezone", "value": "UTC" }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" }, { "description": "A/B Single Sends have multiple variation IDs and phase IDs. Including these additional fields allows further granularity of stats by these fields.", "key": "group_by", "value": "ab_variation,ab_phase" } ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"results\": [\n {\n \"id\": \"\",\n \"ab_variation\": \"a14dcc63-d651-4c57-9826-4a3705f5c78d\",\n \"ab_phase\": \"test\",\n \"aggregation\": \"total\",\n \"stats\": {\n \"bounce_drops\": \"\",\n \"bounces\": \"\",\n \"clicks\": \"\",\n \"delivered\": \"\",\n \"invalid_emails\": \"\",\n \"opens\": \"\",\n \"requests\": \"\",\n \"spam_report_drops\": \"\",\n \"spam_reports\": \"\",\n \"unique_clicks\": \"\",\n \"unique_opens\": \"\",\n \"unsubscribes\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"ab_variation\": \"a14dcc63-d651-4c57-9826-4a3705f5c78d\",\n \"ab_phase\": \"test\",\n \"aggregation\": \"total\",\n \"stats\": {\n \"bounce_drops\": \"\",\n \"bounces\": \"\",\n \"clicks\": \"\",\n \"delivered\": \"\",\n \"invalid_emails\": \"\",\n \"opens\": \"\",\n \"requests\": \"\",\n \"spam_report_drops\": \"\",\n \"spam_reports\": \"\",\n \"unique_clicks\": \"\",\n \"unique_opens\": \"\",\n \"unsubscribes\": \"\"\n }\n }\n ],\n \"_metadata\": {\n \"prev\": \"\",\n \"self\": \"\",\n \"next\": \"\",\n \"count\": \"\"\n }\n}", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-0675a9bb-7f82-4bf5-b5eb-1a3da525e8a9" }, { "id": "6644e1c3-ce5f-4577-8f9c-a0cf7569eee0", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/singlesends/:id?aggregated_by=day&start_date=2021-01-01&end_date=2021-12-31&timezone=UTC&page_size=25&page_token=&group_by=ab_variation,ab_phase", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "singlesends", ":id" ], "query": [ { "description": "Dictates how the stats are time-sliced. Currently, `\"total\"` and `\"day\"` are supported.", "key": "aggregated_by", "value": "day" }, { "description": "Format: `YYYY-MM-DD`. If this parameter is included, the stats' start date is included in the search.", "key": "start_date", "value": "2021-01-01" }, { "description": "Format: `YYYY-MM-DD`.If this parameter is included, the stats' end date is included in the search.", "key": "end_date", "value": "2021-12-31" }, { "description": "[IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented, e.g., \"America/Chicago\".", "key": "timezone", "value": "UTC" }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" }, { "description": "A/B Single Sends have multiple variation IDs and phase IDs. Including these additional fields allows further granularity of stats by these fields.", "key": "group_by", "value": "ab_variation,ab_phase" } ], "variable": [ { "key": "id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-6644e1c3-ce5f-4577-8f9c-a0cf7569eee0" }, { "id": "64afb64f-5f94-465d-a7b1-900e6d9bb119", "name": "response", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/singlesends/:id?aggregated_by=day&start_date=2021-01-01&end_date=2021-12-31&timezone=UTC&page_size=25&page_token=&group_by=ab_variation,ab_phase", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "singlesends", ":id" ], "query": [ { "description": "Dictates how the stats are time-sliced. Currently, `\"total\"` and `\"day\"` are supported.", "key": "aggregated_by", "value": "day" }, { "description": "Format: `YYYY-MM-DD`. If this parameter is included, the stats' start date is included in the search.", "key": "start_date", "value": "2021-01-01" }, { "description": "Format: `YYYY-MM-DD`.If this parameter is included, the stats' end date is included in the search.", "key": "end_date", "value": "2021-12-31" }, { "description": "[IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented, e.g., \"America/Chicago\".", "key": "timezone", "value": "UTC" }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" }, { "description": "A/B Single Sends have multiple variation IDs and phase IDs. Including these additional fields allows further granularity of stats by these fields.", "key": "group_by", "value": "ab_variation,ab_phase" } ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-64afb64f-5f94-465d-a7b1-900e6d9bb119" } ], "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-9b4e48be-18ed-4904-947b-b8fc44fbdaa9" } ], "id": "afb4eeef-3ea6-4327-a347-fcf61a33f568", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-afb4eeef-3ea6-4327-a347-fcf61a33f568" }, { "name": "export", "item": [ { "name": "Export Single Send Stats", "id": "7251022b-1e2a-4bbc-be59-4409362dc0da", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/singlesends/export?ids=&timezone=UTC", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "singlesends", "export" ], "query": [ { "description": "The IDs of Single Sends for which to export stats.", "key": "ids", "value": "" }, { "description": "The [IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented; i.e. `\"America/Chicago\"`. This parameter changes the timezone format only; it does not alter which stats are returned.", "key": "timezone", "value": "UTC" } ] }, "description": "**This endpoint allows you to export Single Send stats as .CSV data**.\n\nYou can specify one Single Send or many: include as many Single Send IDs as you need, separating them with commas, as the value of the `ids` query string parameter.\n\nThe data is returned as plain text response but in .CSV format, so your application making the call can present the information in whatever way is most appropriate, or just save the data as a .csv file." }, "response": [ { "id": "9e58f643-02eb-471c-a2fa-523b82149217", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/singlesends/export?ids=&timezone=UTC", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "singlesends", "export" ], "query": [ { "description": "The IDs of Single Sends for which to export stats.", "key": "ids", "value": "" }, { "description": "The [IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented; i.e. `\"America/Chicago\"`. This parameter changes the timezone format only; it does not alter which stats are returned.", "key": "timezone", "value": "UTC" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-9e58f643-02eb-471c-a2fa-523b82149217" }, { "id": "cb73df0b-9343-4736-b035-2a5d6413078e", "name": "response", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/singlesends/export?ids=&timezone=UTC", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "singlesends", "export" ], "query": [ { "description": "The IDs of Single Sends for which to export stats.", "key": "ids", "value": "" }, { "description": "The [IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented; i.e. `\"America/Chicago\"`. This parameter changes the timezone format only; it does not alter which stats are returned.", "key": "timezone", "value": "UTC" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-cb73df0b-9343-4736-b035-2a5d6413078e" } ], "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-7251022b-1e2a-4bbc-be59-4409362dc0da" } ], "id": "697700e2-d165-4a07-832e-4e058a75d48c", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-697700e2-d165-4a07-832e-4e058a75d48c" }, { "name": "Get All Single Sends Stats", "id": "6b49fd24-5f03-4d28-b362-2a1331171d54", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/singlesends?singlesend_ids=&page_size=25&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "singlesends" ], "query": [ { "description": "This endpoint returns all Single Send IDs if no IDs are included in `singlesend_ids`.", "key": "singlesend_ids", "value": "" }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" } ] }, "description": "**This endpoint allows you to retrieve stats for all your Single Sends.**\n\nBy default, all of your Single Sends will be returned, but you can specify a selection by passing in a comma-separated list of Single Send IDs as the value of the query string parameter `singlesend_ids`.\n\nResponses are paginated. You can limit the number of responses returned per batch using the `page_size` query string parameter. The default is 25, but you specify a value between 1 and 50.\n\nYou can retrieve a specific page of responses with the `page_token` query string parameter." }, "response": [ { "id": "42d6d32e-c1ce-4582-baf3-1839eeae6fdd", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/singlesends?singlesend_ids=&page_size=25&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "singlesends" ], "query": [ { "description": "This endpoint returns all Single Send IDs if no IDs are included in `singlesend_ids`.", "key": "singlesend_ids", "value": "" }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"results\": [\n {\n \"id\": \"\",\n \"ab_variation\": \"a14dcc63-d651-4c57-9826-4a3705f5c78d\",\n \"ab_phase\": \"test\",\n \"aggregation\": \"total\",\n \"stats\": {\n \"bounce_drops\": \"\",\n \"bounces\": \"\",\n \"clicks\": \"\",\n \"delivered\": \"\",\n \"invalid_emails\": \"\",\n \"opens\": \"\",\n \"requests\": \"\",\n \"spam_report_drops\": \"\",\n \"spam_reports\": \"\",\n \"unique_clicks\": \"\",\n \"unique_opens\": \"\",\n \"unsubscribes\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"ab_variation\": \"a14dcc63-d651-4c57-9826-4a3705f5c78d\",\n \"ab_phase\": \"test\",\n \"aggregation\": \"total\",\n \"stats\": {\n \"bounce_drops\": \"\",\n \"bounces\": \"\",\n \"clicks\": \"\",\n \"delivered\": \"\",\n \"invalid_emails\": \"\",\n \"opens\": \"\",\n \"requests\": \"\",\n \"spam_report_drops\": \"\",\n \"spam_reports\": \"\",\n \"unique_clicks\": \"\",\n \"unique_opens\": \"\",\n \"unsubscribes\": \"\"\n }\n }\n ],\n \"_metadata\": {\n \"prev\": \"\",\n \"self\": \"\",\n \"next\": \"\",\n \"count\": \"\"\n }\n}", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-42d6d32e-c1ce-4582-baf3-1839eeae6fdd" }, { "id": "222c2ada-19bf-4e46-bf2f-2c4ba60a5157", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/stats/singlesends?singlesend_ids=&page_size=25&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "stats", "singlesends" ], "query": [ { "description": "This endpoint returns all Single Send IDs if no IDs are included in `singlesend_ids`.", "key": "singlesend_ids", "value": "" }, { "description": "The number of elements you want returned on each page.", "key": "page_size", "value": "25" }, { "description": "The stats endpoints are paginated. To get the next page, call the passed `_metadata.next` URL. If `_metadata.prev` doesn't exist, you're at the first page. Similarly, if `_metadata.next` is not present, you're at the last page.", "key": "page_token", "value": "" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-222c2ada-19bf-4e46-bf2f-2c4ba60a5157" } ], "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-6b49fd24-5f03-4d28-b362-2a1331171d54" } ], "id": "758947e3-84fb-40bf-9e00-38f5c1ad18cb", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-758947e3-84fb-40bf-9e00-38f5c1ad18cb" } ], "id": "b12d0118-23d9-4cb4-8292-0fb52a2e6b44", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-b12d0118-23d9-4cb4-8292-0fb52a2e6b44" } ], "id": "552b109c-aa7a-4e12-9ad7-98ca9dc0a01b", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-552b109c-aa7a-4e12-9ad7-98ca9dc0a01b" } ], "id": "bd0dae0d-f5b4-4695-9204-484d87106634", "createdAt": "2026-06-05T15:17:37.000Z", "updatedAt": "2026-06-05T15:17:37.000Z", "uid": "35240-bd0dae0d-f5b4-4695-9204-484d87106634" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.sendgrid.com" } ] }