List inbox placement blacklist & spamassassin report

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

GET /api/v2/inbox-placement-reports

List inbox placement blacklist & spamassassin report

cURL

curl --request GET \
  --url https://api.instantly.ai/api/v2/inbox-placement-reports \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "id": "019e3bd1-8dbd-7fdb-bfa7-a0816058c54b",
      "timestamp_created": "2026-05-18T16:00:49.597Z",
      "timestamp_created_date": "2026-05-18",
      "organization_id": "019e3bd1-8dbd-7fdb-bfa7-a082db93cd63",
      "test_id": "019e3bd1-8dbd-7fdb-bfa7-a08336202a96",
      "domain": "growinstantly.com",
      "domain_ip": "192.168.1.1",
      "spam_assassin_score": 2.5,
      "domain_blacklist_count": 5,
      "domain_ip_blacklist_count": 3,
      "spam_assassin_report": {
        "is_spam": false,
        "report": [
          {
            "description": "BODY",
            "name": "HTML_MESSAGE",
            "score": "0.0"
          }
        ],
        "spam_score": 0
      },
      "blacklist_report": {
        "address": "growinstantly.com",
        "blacklisted_count": 5,
        "details": [
          {
            "blacklist": "zen.spamhaus.org",
            "is_listed": true,
            "test_type": "ip"
          }
        ],
        "ip": "104.21.62.47",
        "is_blacklisted": true,
        "is_domain": true
      }
    }
  ],
  "next_starting_after": "019e3bd1-b5ab-762b-a148-d800d0bcb523"
}

Authorizations

Authorization · string · header · required

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

Query Parameters

limit · integer

The number of items to return

Required range: 1 <= x <= 100

Example:

10

starting_after · string

The ID of the last item in the previous page - used for pagination. You can use the value of the next_starting_after field from the previous response.

Example:

"01956fbd-0eb1-72db-a565-82977a586084"

test_id · string<uuid> · required

Example:

"d290f1ee-6c54-4b01-90e6-d701748f0851"

date_from · string

Example:

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

date_to · string

Example:

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

skip_spam_assassin_report · boolean

Flag to skip including spam_assassin_report JSON

Example:

false

skip_blacklist_report · boolean

Flag to skip including blacklist_report JSON

Example:

false

Response

200

application/json

The list of Inbox Placement Blacklist & SpamAssassin Report

items · Inbox Placement Blacklist & SpamAssassin Report · object[] · required

The list of Inbox Placement Blacklist & SpamAssassin Report

Show child attributes

next_starting_after · string

The filter for getting the next items after this one, this could either be a UUID, a timestamp, on an email depending on the specific API

Example:

"019e3bd1-b5ab-762b-a148-d800d0bcb523"