Read-only

List And Export Contacts

Query your contact database with rich filtering by connection status, response status, campaign membership, custom attributes, or tags. Returns results as JSON by default or as CSV when format='csv' for bulk export, with cursor-based pagination for large lists. Use it to segment your audience, build export files, or pull a precise slice of contacts for downstream work.

list_contactsGET/api/v1/contacts

Get started View docs

crispy — bash

Example prompt: Export all connected contacts in my gtm-engineers campaign who have not responded yet as a CSV

{
  "contacts": [
    {
      "crispy_id": "c_8f21",
      "first_name": "Jane",
      "company": "Revolut",
      "connection_status": "connected",
      "response_status": "awaiting_response"
    }
  ],
  "cursor": null
}

Permission scope

core

Access

Read-only

What you can build

Export every connected contact in a campaign to CSV for reporting or backup

Segment contacts who are awaiting a response and have not been messaged recently

Pull all contacts carrying a specific tag or custom attribute for targeted follow-up

Page through thousands of contacts with cursor pagination to feed another workflow

Parameters

Inputs accepted by list_contacts.

Name	Type	Required	Description
list_id	`string`	optional	Scope to a specific list ID (omit for all contacts)
connection_status	`"connected" \| "not_connected" \| "invitation_pending" \| "invitation_declined" \| "invitation_withdrawn" \| "unknown"`	optional	Filter by connection status
response_status	`"responded" \| "awaiting_response" \| "never_messaged"`	optional	Filter by response status (computed from message timestamps)
in_campaign	`boolean`	optional	true = contacts currently in a campaign; false = not in any campaign
campaign_id	`string`	optional	Filter to contacts in a specific campaign
last_touched_before	`string`	optional	ISO timestamp, contacts last touched before this date
last_touched_after	`string`	optional	ISO timestamp, contacts last touched after this date
custom_attrs	`object`	optional	Exact-match filter on custom attrs (e.g. {industry: 'SaaS'})
tags	`string[]`	optional	Any-match filter on tags (OR)
tag_ids	`string[]`	optional	Filter contacts by tag IDs (from list_tags). OR-match against contact_tags join table.
format	`"json" \| "csv"`	optional	Response format (default json)
limit	`number`	optional	Results per page (default 100, max 5000)
cursor	`string`	optional	Pagination cursor from previous response

Related tools

Get Full Contact Picture

Get the complete LinkedIn contact picture in one call: identifiers, campaigns, messages, connection events, company, lead score, and next-best-action.

Search Saved Leads

Search your saved LinkedIn leads and contacts by name, status, tags, or company. Filter to new, contacted, replied, or qualified leads in one call.

Bulk Import Contacts

Bulk-import LinkedIn contacts from JSON, CSV, URL, or storage with merge, replace, or skip strategies. Preview before committing and track per-record skips.

List Contact Tags

List every tag in your account with id, name, and color so you can organize and segment LinkedIn contacts via MCP.

Explore all Lead Management tools

The complete LinkedIn API. Ready when you are.

Connect your first LinkedIn profile in under 5 minutes. Every tool, every seat, no feature gates. Safe limits, warm-up, and full permission control built in.

Start now Read the docs