Skip to main content
GET
Get contact

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 ID of the workspace containing the contact. Use the workspace_id returned when listing contacts.

Minimum string length: 1
contact_id
string
required

The contact ID.

Minimum string length: 1

Response

The requested contact.

The requested contact.

id
string
required

The contact ID.

workspace_id
string
required

The ID of the workspace used to retrieve the contact.

type
enum<string>
required

Whether the contact belongs to a personal workspace (personal) or a team workspace (business).

Available options:
personal,
business
first_name
string | null
required

The contact's first name, or null when no first name is saved.

middle_name
string | null
required

The contact's middle name.

last_name
string | null
required

The contact's last name, or null when no last name is saved.

full_name
string | null
required

The contact's full name, or null when no name is saved.

preferred_name
string | null
required

The name the contact prefers to use.

pronouns
string | null
required

The contact's pronouns.

job_title
string | null
required

The contact's job title.

company_name
string | null
required

The name of the contact's company.

department
string | null
required

The contact's department within their company.

headline
string | null
required

The contact's profile headline.

avatar_url
string | null
required

The URL of the contact's profile image, or null when there is none.

company_logo_url
string | null
required

The URL of the contact's company logo, or null when there is none.

emails
object[]
required

The contact's email addresses and their labels.

phone_numbers
object[]
required

The contact's phone numbers and their labels, country codes, and extensions.

urls
object[]
required

The contact's website and social profile URLs and their labels.

addresses
object[]
required

The contact's postal addresses as text values with labels.

tags
object[]
required

Tags assigned to the contact.

contact_notes
object[]
required

Text notes saved on the contact.

linked_notes
object[]
required

Metadata for notes linked to the contact, including each note's ID, title, creation time, and type.

capture_context
object | null
required

Saved capture metadata, not evidence of a meeting. For business contacts, location and cardholder refer to the selected earliest recipient. null means no capture metadata is available.

created_at
string<date-time> | null
required

When the contact was created, as an ISO 8601 timestamp.

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)))$
updated_at
string<date-time> | null
required

When the contact was last updated, as an ISO 8601 timestamp.

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)))$