contacts

Query and export contacts with rich filtering. Filter by connection/response status, campaign, custom attrs, or tags. Re

get/api/v1/contacts

Request

  • Base URL: https://crispy.sh
  • URL: https://crispy.sh/api/v1/contacts
  • Auth: HTTP bearer

Query parameters

list_idstring

Scope to a specific list ID (omit for all contacts)

connection_status'connected' | 'not_connected' | 'invitation_pending' | 'invitation_declined' | 'invitation_withdrawn' | 'unknown'

Filter by connection status

response_status'responded' | 'awaiting_response' | 'never_messaged'

Filter by response status (computed from message timestamps)

in_campaignboolean

true = contacts currently in a campaign; false = not in any campaign

campaign_idstring

Filter to contacts in a specific campaign

last_touched_beforestring

ISO timestamp — contacts last touched before this date

last_touched_afterstring

ISO timestamp — contacts last touched after this date

custom_attrsobject

Exact-match filter on custom attrs (e.g. {industry: 'SaaS'})

tagsstring[]

Any-match filter on tags (OR)

tag_idsstring[]

Filter contacts by tag IDs (from list_tags). OR-match against contact_tags join table.

format'json' | 'csv'

Response format (default json)

limitnumber

Results per page (default 100, max 1000)

cursorstring

Pagination cursor from previous response

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.