---
title: "List LinkedIn activity"
method: POST
path: "/v3/reporting/linkedin"
tags: ["Reports"]
---

# List LinkedIn activity

`POST /v3/reporting/linkedin`

<small>_Requires the `reporting:read` scope (or a broader one that includes it)._</small>

Returns a paginated list of individual LinkedIn action records matching the specified filters.

## Query parameters

- `top` integer
- `skip` integer

## Request body

- object
  - `filters` object, required — Filters specific to LinkedIn reporting endpoints
    - `from` string, date-time — Start date of the reporting period
    - `to` string, date-time — End date of the reporting period
    - `dateRangePreset` 'lastWeek' | 'lastMonth' | 'lastYear' | 'allTime' — Predefined date range shortcut. Defaults to lastWeek when neither dateRangePreset nor from/to are provided. Use allTime to retrieve the full historical report. Cannot be combined with from/to.
    - `teamIds` integer[] — Filter by team IDs
    - `userIds` integer[] — Filter by user IDs
    - `contactListIds` integer[] — Filter by contact list IDs
    - `emailValidationStatuses` string[] — Filter by email validation status
    - `companies` string[] — Filter by company names
    - `companySizes` string[] — Filter by company size ranges
    - `industries` string[] — Filter by industry names
    - `cities` string[] — Filter by city names
    - `states` string[] — Filter by state/region names
    - `countries` string[] — Filter by country names
    - `titles` string[] — Filter by job titles
    - `sequenceIds` integer[] — Filter by sequence IDs
    - `includeOutOfSequence` boolean — Include activity outside of sequences
    - `emailProviders` string[] — Filter by email provider type
    - `linkedInAccountIds` integer[] — Filter by LinkedIn account IDs

## Response `200`

LinkedIn actions list retrieved successfully

- object
  - `items` object[]
    - `contactId` integer — ID of the contact (may be null for unmatched actions)
    - `contactFirstName` string — Contact's first name
    - `contactLastName` string — Contact's last name
    - `contactEmail` string, email — Contact's email address
    - `contactLinkedInUrl` string — Contact's LinkedIn profile URL
    - `senderLinkedInAccountName` string — Name of the LinkedIn account that performed the action
    - `sequenceName` string — Name of the sequence
    - `sequenceStepNumber` integer — Step number within the sequence
    - `sequenceStepDisplayName` string — Display name of the sequence step
    - `actionDate` string, date-time — Date the action was performed
    - `actionType` 'unknown' | 'acceptedAutoConnection' | 'sentAutoConnection' | 'sentManualConnection' | 'repliedAutoConnectionNote' | 'sentAutoConnectionNote' | 'repliedAutoMessage' | 'sentAutoMessage' | 'sentManualMessage' | 'repliedAutoInMail' | 'sentAutoInMail' | 'sentManualInMail' | 'autoProfileView' | 'manualProfileView' | 'like' | 'followProfile' | 'endorseSkills' — Type of LinkedIn action performed
  - `hasMore` boolean — Indicates if there are more items to fetch

## Other responses

- `400` — Invalid pagination parameters, or request-body validation failure (FluentValidator).
- `401` — Unauthorized. The response body is empty; check the `WWW-Authenticate` header for the expected scheme.
- `403` — User lacks required feature scope to view reports.
- `429` — Too Many Requests

---

[API](https://skmtc.net/reply/apis/reply-api.md) · [All operations](https://skmtc.net/reply/apis/reply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reply/reply-api/revisions/1c3d32eaf95e/schema)