Skip to main content
GET
List contacts

Authorizations

Authorization
string
header
required

Send a Blinq API key as Authorization: Bearer <api-key>; enter only the key in the documentation playground.

Create and revoke keys in the Blinq web app under Settings > API keys.

The key needs the scopes required by the operation, and public API access requires a Pro or Business plan.

Path Parameters

workspace_id
string
required

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

Minimum string length: 1

Query Parameters

cursor
string

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

Minimum string length: 1

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

Minimum string length: 1
updated_at_gte
string<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.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
created_at_gte
string<date-time>

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

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
created_at_lte
string<date-time>

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

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
limit
integer
default:25

The maximum number of contacts to return per page.

Required range: x <= 50

Response

One page of contact summaries.

One page of contact summaries.

contacts
object[]
required

Contact summaries for this page. Empty when no contacts match the request.

has_more
boolean
required

Whether another page of contacts is available.

next_cursor
string | null
required

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

total_count
integer | null
required

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

Required range: 0 <= x <= 9007199254740991