INinstantly
InboxPlacementAnalytics

Get inbox placement analytics stats by date

Provides a time series representing the distribution of emails sent to inbox, spam, or category folders for scheduled inbox placement tests.

Requires one of the following scopes: inbox_placement_analytics:read, inbox_placement_analytics:all, all:read, all:all

post/api/v2/inbox-placement-analytics/stats-by-date

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/inbox-placement-analytics/stats-by-date
  • Auth
    HTTP bearer

Request body

test_idstring uuid required
date_fromstring
date_tostring
recipient_geonumber[]
recipient_typenumber[]
recipient_espnumber[]
sender_emailstring

Example request

{
  "test_id": "01a19e6f-8cfa-722a-a0c3-026e1a30b075",
  "date_from": "2026-11-02T22:44:33.146Z",
  "date_to": "2026-11-02T22:44:33.146Z",
  "recipient_geo": [
    1
  ],
  "recipient_type": [
    1
  ],
  "recipient_esp": [
    1,
    2
  ],
  "sender_email": "john@doe.com"
}

Response

Default Response

timestamp_created_datestring required
sent_countnumber required
received_countnumber required
spam_countnumber required
inbox_countnumber required
category_countnumber required

Example response

[
  {
    "timestamp_created_date": "2026-11-02T22:44:33.146Z",
    "sent_count": 1,
    "received_count": 1,
    "spam_count": 1,
    "inbox_count": 1,
    "category_count": 1
  }
]

Changes

No recorded changes to this operation across all 6 revisions of this API.