List contacts

Lists LinkedIn contacts.

get/v1/contacts

Request

Base URL: https://api.talktohumans.app
URL: https://api.talktohumans.app/v1/contacts
Auth: HTTP bearer

Query parameters

account_idstring[]

LinkedIn account IDs returned by GET /v1/accounts.

Repeat the query parameter for multiple accounts. The backend also accepts comma-separated values. If an explicit account target is not accessible to this credential, the API returns 403 account_shared_access_required.

querystring

Search by name, headline, company, role, LinkedIn handle, or profile URL.

company_namestring

Filter by current or past company name.

headlinestring

Filter by headline text.

searchstring

Search broadly across profile details, tags, notes, locations, work history, education, and company data.

locationstring

Filter by location text.

company_sizestring

Filter by company size or employee count.

tagstring

Filter by tag name.

relationship_status'any' | 'connected' | 'not_connected' | 'unknown'

Filter by LinkedIn relationship state. Defaults to any.

invitation_status'pending'

Filter by invitation state. Only pending is currently supported.

conversation_idstring

Return contacts who participate in the given TalkToHumans conversation.

view_idstring

Return only contacts that belong to a saved TalkToHumans view (list). Accepts the view id or public_id returned by GET /v1/views. Works for views created in the app and views created with POST /v1/views. Results are scoped to the view's LinkedIn account.

limitinteger

Page size. Defaults to 10. Values above 25 are clamped to 25.

cursorstring

Opaque cursor from the previous response's pagination.next_cursor.

Response

Contacts matching the filters.

Example response

{
  "data": {
    "pagination": {
      "limit": 10
    }
  }
}

Changes

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