# list_connections: List my connections

List your 1st-degree connections. This action only reads; it changes nothing. Plan: Free and Connect.

```
POST https://api.heyreagent.com/v1/actions/list_connections
Authorization: Bearer YOUR_KEY
content-type: application/json

{}
```

## What you give it

- `connectionId` (optional): a connection id. Restrict to one LinkedIn sender (its linkedinConnections _id from list_linkedin_accounts). Omit to merge across all your live senders in this setup. Where to get it: Run `list_linkedin_accounts` and use `accounts[].id`.
- `since` (optional): text. ISO date (e.g. "2026-01-01"). Only return connections made on/after this date.
- `search` (optional): text. Case-insensitive substring matched against each person's name and headline.
- `limit` (optional): a number, 1 to 500. Max people to return (1–500, default 200). The total match count is always reported even when truncated.
- `refresh` (optional): true or false. true = pull the latest connections live from LinkedIn and refresh the cache (slower). false (default) = serve from cache, refreshing live only when the cache is empty or stale.

## What you get back

- `summary`
- `connections`
- `note`

## Good to know

- connections[].connectionId is YOUR account the person is connected to, not the person.
- No member id comes back. Pass profileUrl on; a action that needs the id resolves it, or get_profile_details returns it.
- Served from a stored copy up to 24 hours old; refresh true reads LinkedIn again.

Page: https://heyreagent.com/docs/actions/list_connections