BLblinq
Contacts

List contacts

Returns a paginated list of contact summaries from your personal workspace or a business workspace you own or administer. Business members receive an empty list. The workspace path segment only narrows which accessible contacts are returned; it never grants additional access.

Deleted contacts, hidden contacts, and company-directory entries are excluded.

Contacts are sorted by creation time, newest first, with the contact ID as a tie-breaker, so pages are deterministic.

Use a contact's id to retrieve its full details from the same workspace.

Requires the blinq:contacts:read scope.

get/v1/workspaces/{workspace_id}/contacts

Request

  • Base URL
    https://api.blinq.me
  • Auth
    HTTP bearer

Path parameters

workspace_idstring required

The workspace ID. Use an id returned by the list workspaces endpoint.

Query parameters

cursorstring

The next_cursor returned by the previous response. Omit for the first page. Keep filters unchanged between pages.

searchstring

Filters contacts using a case-insensitive substring match against card names, job titles, company names, and saved text notes.

updated_at_gtestring date-time

Return contact records last updated at or after this ISO 8601 timestamp with a timezone, such as 2026-10-01T00:00:00Z (inclusive). Deleted contacts are excluded. Changes to linked resources do not necessarily update the contact record.

created_at_gtestring date-time

Include contacts created at or after this ISO 8601 timestamp with a timezone, such as 2026-10-01T00:00:00Z (inclusive).

created_at_ltestring date-time

Include contacts created at or before this ISO 8601 timestamp with a timezone, such as 2026-10-31T23:59:59Z (inclusive).

limitinteger

The maximum number of contacts to return per page.

Response

One page of contact summaries.

has_moreboolean required

Whether another page of contacts is available.

next_cursorstring nullable required

The cursor for the next page. When has_more is true, pass this value as cursor. Otherwise, this value is null.

total_countinteger nullable required

The total number of contacts matching the filters across all pages. Returned on the first page; null on subsequent pages.

Changes

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