Docs
Deliverability

Get inbox vs spam by provider (bulk)

Inbox vs spam by recipient provider for up to 50 accounts

Batched form of GET accounts/{id}/analytics/esp, with the same window, esps and timeZone fields in the body. POST rather than GET because the id list can exceed a practical query-string length. Partial-succeed: an account that cannot be read is reported in failed while the rest still return.

POST
/v2/workspaces/{workspaceId}/analytics/accounts/esp

Path Parameters

workspaceIdnumber
accountIdsarray<number>

Account ids to read. Max 50 per request.

fromstring

Start date, inclusive (YYYY-MM-DD)

tostring

End date, inclusive (YYYY-MM-DD)

esps?array<string>

ESPs to include. Defaults to all of gmail, outlook, other.

Value in"gmail" | "outlook" | "other"
timeZone?string

IANA time zone for day boundaries, e.g. Asia/Kolkata

Default"UTC"

Response Body

curl -X POST "https://lynx-api.trulyinbox.com/v2/workspaces/0/analytics/accounts/esp" \  -H "Content-Type: application/json" \  -d '{    "accountIds": [      1,      2,      3    ]  }'
{
  "data": {
    "from": "2026-11-01",
    "to": "2026-11-19",
    "accounts": [
      {
        "accountId": 12,
        "perEsp": [
          {
            "esp": "gmail",
            "sentCount": 0,
            "inboxCount": 0,
            "spamCount": 0,
            "deliverabilityRate": 0
          }
        ],
        "totalSentCount": 1500,
        "totalInboxCount": 1320,
        "totalSpamCount": 180,
        "deliverabilityRate": 88
      }
    ],
    "failed": [
      {
        "accountId": 456,
        "reason": "not_found"
      }
    ]
  },
  "meta": {
    "request_id": "req_2f1c…",
    "timestamp": "2019-08-24T14:15:22Z"
  }
}
{
  "error": {
    "code": "invalid_request",
    "message": "string",
    "details": {},
    "retry_after": 34
  },
  "meta": {
    "request_id": "req_2f1c…",
    "timestamp": "2019-08-24T14:15:22Z"
  }
}
{
  "error": {
    "code": "invalid_request",
    "message": "string",
    "details": {},
    "retry_after": 34
  },
  "meta": {
    "request_id": "req_2f1c…",
    "timestamp": "2019-08-24T14:15:22Z"
  }
}