Skip to main content
GET
/
v1
/
email
/
correspondents
List Top Correspondents
curl --request GET \
  --url https://api.example.com/v1/email/correspondents
{
  "data": {
    "correspondents": [
      {
        "email": "<string>",
        "display_name": "<string>",
        "contact_id": "<string>",
        "company_name": "<string>",
        "message_count": 123,
        "sent_count": 123,
        "received_count": 123,
        "last_message_at": "<string>"
      }
    ]
  }
}

​
Request

This endpoint is the fastest way to surface the people your team is actively emailing, ranked by recency and volume. It is the data source behind the sidebar’s “Top correspondents” widget.

​
Query Parameters

​
limit
integer
default:"25"
Number of correspondents to return. Maximum 200.
​
since
string
Optional ISO 8601 lower-bound on the messages considered (e.g. the last 30 days).
​
user_id
string
Scope the aggregation to a single user in the workspace. When omitted, every connected mailbox is aggregated.
​
min_messages
integer
default:"2"
Exclude correspondents who have exchanged fewer than this number of messages.

​
Headers

Authorization: Bearer wbk_your_api_key_here

​
Response

​
data
object
Responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and X-Request-ID headers. 
curl "https://data.leadlex.com/functions/v1/api-gateway/v1/email/correspondents?limit=50" \
  -H "Authorization: Bearer wbk_your_api_key_here"

​
Example Response

{
  "data": {
    "correspondents": [
      {
        "email": "jane@acme.com",
        "display_name": "Jane Doe",
        "contact_id": "123e4567-e89b-12d3-a456-426614174000",
        "company_name": "Acme Corp",
        "message_count": 42,
        "sent_count": 21,
        "received_count": 21,
        "last_message_at": "2026-04-17T09:14:00Z"
      }
    ]
  }
}

​
Errors

StatusCodeDescription
401invalid_keyInvalid or expired API key
403insufficient_permissionsMissing read:email permission
429rate_limitedRate limit exceeded