INinstantly
InboxPlacementAnalytics

Retrieve inbox placement analytics stats by test id

Provides aggregated inbox, spam and category counts for specified test IDs

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-test-id

Request

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

Request body

test_idsstring[] required
date_fromstring
date_tostring
recipient_geonumber[]
recipient_typenumber[]
recipient_espnumber[]
sender_emailstring

Example request

{
  "test_ids": [
    "01a19e6f-8886-7f3e-a3d2-e626fc533ab0"
  ],
  "date_from": "2026-11-02T22:44:32.006Z",
  "date_to": "2026-11-02T22:44:32.006Z",
  "recipient_geo": [
    1
  ],
  "recipient_type": [
    1
  ],
  "recipient_esp": [
    1,
    2
  ],
  "sender_email": "john@doe.com"
}

Response

Default Response

test_idstring uuid required
countnumber required
spam_countnumber required
spam_percentnumber required
inbox_countnumber required
inbox_percentnumber required
category_countnumber required
category_percentnumber required

Example response

[
  {
    "test_id": "01a19e6f-8886-7f3e-a3d2-e6273380aa53",
    "count": 1,
    "spam_count": 1,
    "spam_percent": 1,
    "inbox_count": 1,
    "inbox_percent": 1,
    "category_count": 1,
    "category_percent": 1
  }
]

Changes

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