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

Get inbox placement analytics stats by date

cURL

curl --request POST \
  --url https://api.instantly.ai/api/v2/inbox-placement-analytics/stats-by-date \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "test_id": "019e3bd1-b5a5-7c03-9846-bd1df7fb8429"
}
'

200

[
  {
    "timestamp_created_date": "2026-05-18T16:00:59.813Z",
    "sent_count": 1,
    "received_count": 1,
    "spam_count": 1,
    "inbox_count": 1,
    "category_count": 1
  }
]

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

test_id · string<uuid> · required

Example:

"019e3bd1-b5a5-7c03-9846-bd1df7fb8429"

date_from · string

Example:

"2026-05-18T16:00:59.813Z"

date_to · string

Example:

"2026-05-18T16:00:59.813Z"

recipient_geo · enum<number>[]

Available options: 1, 2, 3, 4

Example:

[1]

recipient_type · enum<number>[]

Available options: 1, 2

Example:

[1]

recipient_esp · enum<number>[]

Available options: 1, 2, 12, 13

Example:

[1, 2]

sender_email · string

Example:

"[e-mail]"

Response

200

application/json

Default Response

timestamp_created_date · string · required

Example:

"2026-05-18T16:00:59.813Z"

sent_count · number · required

Example:

1

received_count · number · required

Example:

1

spam_count · number · required

Example:

1

inbox_count · number · required

Example:

1

category_count · number · required

Example:

1