Inbox Placement Blacklist & SpamAssassin Report

API Explorer (2.0.0)

The entire API V2 documentation is interactive and can be tested here. To the right side of every endpoint you will see a box with an example request. You can click on the "Try it" button to send a request to the server right from the docs. You will need to provide an API key by clicking the ApiKeyAuth_token blue text.

Servers

Instantly API Server

https://api.instantly.ai/

Mock server

https://developer.instantly.ai/_mock/api/v2/

Analytics

Endpoints related to analytics

Operations

Account

An email account that can be used to send campaigns

Operations

Campaign

A campaign that can be sent to a list of recipients

Operations

Email

A campaign email, a reply, a manually sent email, or any other email that's visible in the Unibox

Operations

Email Verification

A single email verification

Operations

Lead List

A list used to store leads

Operations

Inbox Placement Test

An inbox placement test

Operations

Inbox Placement Analytics

Analytics data for individual emails in inbox placement tests

Operations

Inbox Placement Blacklist & SpamAssassin Report

Report data for an inbox placement test

Operations

API Key

Operations

Account Campaign Mapping

Operations

Lead

A lead entity representing an individual lead

Operations

Background Job

A background job that can be used to perform long-running tasks

Operations

Custom Tag

A custom tag for organizing and categorizing accounts and campaigns. You can use them as filters in apis that list accounts and campaigns.

Operations

Block List Entry

A blocked email or domain

Operations

Lead Label

A custom label for categorizing and managing leads

Operations

Workspace

A workspace entity representing a workspace

Operations

SuperSearch Enrichment

A SuperSearch enrichment that retrieves and enriches leads based on search filters

Operations

Workspace Group Member

A member of a workspace group. You can use the endpoints within this entity to manage the members of a workspace group.

Operations

Workspace Member

A member of a workspace with associated user details

Operations

Campaign Subsequence

A subsequence entity representing a follow-up sequence

Operations

Clause

A clause (filter or sort) that can be applied to variables in campaigns or lists

Audit Log

Audit log records for tracking system activities

Operations

Webhook

A webhook subscription for receiving event notifications

Operations

Schemas

Inbox Placement Analytics

Analytics data for individual emails in inbox placement tests

idstring(uuid)read-onlyrequired

Unique identifier for the inbox placement analytics entry

Example: "019942fb-54a5-7667-aa3e-0672cd4106b9"

timestamp_createdstringread-onlyrequired

Timestamp when the inbox placement analytics was created

Example: "2025-09-13T12:09:51.525Z"

timestamp_created_datestringread-onlyrequired

Date when the inbox placement analytics was created

Example: "2025-09-13"

organization_idstring(uuid)read-onlyrequired

Organization ID

Example: "019942fb-54a5-7667-aa3e-0673a18c2b38"

test_idstring(uuid)required

Inbox Placement Test ID

Example: "019942fb-54a5-7667-aa3e-06743a474883"

is_spamnull or boolean

Indicates if the email landed in spam (null if not determined). Only present when record_type is 2 (received).

Example: true

has_categorynull or boolean

Indicates if the email was categorized like promotions, social, etc. (null if not determined). Only present when record_type is 2 (received).

Example: true

sender_emailnull or string

Email address of the sender

Example: "sender@example.com"

sender_espnull or number

The sender ESP (Email Service Provider). Only present when record_type is 2 (received).

Enum Value	Description
1	Google
2	Microsoft
12	Web.de
13	Libero.it

Example: 1

recipient_emailnull or string

Email address of the recipient

Example: "recipient@example.com"

recipient_espnull or number

The recipient ESP (Email Service Provider)

Enum Value	Description
1	Google
2	Microsoft
12	Web.de
13	Libero.it

Example: 1

recipient_geonull or number

The geographic location of the recipient

Enum Value	Description
1	United States
2	Italy
3	Germany
4	France

Example: 1

recipient_typenull or number

The type of recipient

Enum Value	Description
1	Professional
2	Personal

Example: 1

spf_passnull or boolean

Indicates if the email passed SPF validation. Only present when record_type is 2 (received).

Example: true

dkim_passnull or boolean

Indicates if the email passed DKIM validation. Only present when record_type is 2 (received).

Example: true

dmarc_passnull or boolean

Indicates if the email passed DMARC validation. Only present when record_type is 2 (received).

Example: true

smtp_ip_blacklist_reportnull or object

Blacklist report for the SMTP IP address. Only present when record_type is 2 (received).

authentication_failure_resultsnull or object

Details of authentication failures for SPF, DKIM, and DMARC. Only present when record_type is 2 (received).

record_typenull or number

The type of record (sent or received)

Enum Value	Description
1	Sent
2	Received

Example: 1

{
  "id": "019942fb-54a5-7667-aa3e-0672cd4106b9",
  "timestamp_created": "2025-09-13T12:09:51.525Z",
  "timestamp_created_date": "2025-09-13",
  "organization_id": "019942fb-54a5-7667-aa3e-0673a18c2b38",
  "test_id": "019942fb-54a5-7667-aa3e-06743a474883",
  "is_spam": true,
  "has_category": true,
  "sender_email": "sender@example.com",
  "sender_esp": 1,
  "recipient_email": "recipient@example.com",
  "recipient_esp": 1,
  "recipient_geo": 1,
  "recipient_type": 1,
  "spf_pass": true,
  "dkim_pass": true,
  "dmarc_pass": true,
  "smtp_ip_blacklist_report": null,
  "authentication_failure_results": null,
  "record_type": 1
}

Inbox Placement Blacklist & SpamAssassin Report

Report data for an inbox placement test

idstring(uuid)read-onlyrequired

Unique identifier for the inbox placement report entry

Example: "019942fb-54a7-7d09-9536-987f5b6042b5"

timestamp_createdstringread-onlyrequired

Timestamp when the inbox placement report was created

Example: "2025-09-13T12:09:51.527Z"

timestamp_created_datestringread-onlyrequired

Date when the inbox placement report was created

Example: "2025-09-13"

organization_idstring(uuid)read-onlyrequired

Organization ID

Example: "019942fb-54a7-7d09-9536-988055fe2a3f"

test_idstring(uuid)read-onlyrequired

Inbox Placement Test ID

Example: "019942fb-54a7-7d09-9536-9881a8b1bd5e"

domainstringread-onlyrequired

Domain of the inbox placement report

Example: "growinstantly.com"

domain_ipstringread-onlyrequired

IP address of the domain

Example: "192.168.1.1"

spam_assassin_scorenumberread-onlyrequired

SpamAssassin score for the email, indicating spam likelihood

Example: 2.5

domain_blacklist_countnull or numberread-only

Count of blacklists the domain is listed on

Example: 5

domain_ip_blacklist_countnull or numberread-only

Count of blacklists the domain IP is listed on

Example: 3

spam_assassin_reportobjectread-only

Detailed SpamAssassin analysis report

blacklist_reportobjectread-only

Detailed blacklist report for the domain or IP

{
  "id": "019942fb-54a7-7d09-9536-987f5b6042b5",
  "timestamp_created": "2025-09-13T12:09:51.527Z",
  "timestamp_created_date": "2025-09-13",
  "organization_id": "019942fb-54a7-7d09-9536-988055fe2a3f",
  "test_id": "019942fb-54a7-7d09-9536-9881a8b1bd5e",
  "domain_blacklist_count": 5,
  "domain": "growinstantly.com",
  "domain_ip": "192.168.1.1",
  "domain_ip_blacklist_count": 3,
  "spam_assassin_score": 2.5,
  "spam_assassin_report": {
    "is_spam": false,
    "report": [ … ],
    "spam_score": 0
  },
  "blacklist_report": {
    "address": "growinstantly.com",
    "blacklisted_count": 5,
    "details": [ … ],
    "ip": "104.21.62.47",
    "is_blacklisted": true,
    "is_domain": true
  }
}

API Key

idstring(uuid)read-onlyrequired

Example: "019942fb-548e-7c63-9b88-9a68d192b509"

namestringrequired

Example: "My API Key"

scopesArray of stringsrequired

Items Enum"all:all""all:create""all:read""all:update""all:delete""ai_agents:all""ai_agents:create""ai_agents:read""ai_agents:update""ai_agents:delete"

Example: ["campaigns:create"]

keystringread-onlyrequired

Example: "a1b2c3d4e5f6g7h8i9j0"

organization_idstring(uuid)read-onlyrequired

Example: "019942fb-5498-72a1-aadf-b4f8bc649c6c"

timestamp_createdstring(date-time)read-onlyrequired

Example: "2025-09-13T12:09:51.512Z"

timestamp_updatedstring(date-time)read-onlyrequired

Example: "2025-09-13T12:09:51.512Z"

{
  "id": "019942fb-548e-7c63-9b88-9a68d192b509",
  "name": "My API Key",
  "scopes": [
    "campaigns:create"
  ],
  "key": "a1b2c3d4e5f6g7h8i9j0",
  "organization_id": "019942fb-5498-72a1-aadf-b4f8bc649c6c",
  "timestamp_created": "2025-09-13T12:09:51.512Z",
  "timestamp_updated": "2025-09-13T12:09:51.512Z"
}