---
title: "Get contact"
method: GET
path: "/v1/workspaces/{workspace_id}/contacts/{contact_id}"
tags: ["Contacts"]
---

# Get contact

`GET /v1/workspaces/{workspace_id}/contacts/{contact_id}`

## Request

- Base URL: `https://api.blinq.me`
- URL: `https://api.blinq.me/v1/workspaces/{workspace_id}/contacts/{contact_id}`
- Auth: HTTP bearer

Gets a contact from the specified workspace, including contact details, tags, saved contact notes, linked note metadata, and capture context. Personal contacts must belong to the key owner. Business owners, admins, and members can retrieve a visible business contact when its ID is known; business members cannot discover these IDs through the list endpoint.

Missing contacts and inaccessible workspaces return `404`.

Requires the `blinq:contacts:read` scope.

## Path parameters

- `workspace_id` string, required
- `contact_id` string, required

## Response `200`

The requested contact.

- object: The requested contact.
  - `id` string, required: The contact ID.
  - `workspace_id` string, required: The ID of the workspace used to retrieve the contact.
  - `type` 'personal' | 'business', required: Whether the contact belongs to a personal workspace (`personal`) or a team workspace (`business`).
  - `first_name` string, nullable, required: The contact's first name, or `null` when no first name is saved.
  - `middle_name` string, nullable, required: The contact's middle name.
  - `last_name` string, nullable, required: The contact's last name, or `null` when no last name is saved.
  - `full_name` string, nullable, required: The contact's full name, or `null` when no name is saved.
  - `preferred_name` string, nullable, required: The name the contact prefers to use.
  - `pronouns` string, nullable, required: The contact's pronouns.
  - `job_title` string, nullable, required: The contact's job title.
  - `company_name` string, nullable, required: The name of the contact's company.
  - `department` string, nullable, required: The contact's department within their company.
  - `headline` string, nullable, required: The contact's profile headline.
  - `avatar_url` string, nullable, required: The URL of the contact's profile image, or `null` when there is none.
  - `company_logo_url` string, nullable, 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.
    - `value` string, nullable, required: The saved value of the contact field.
    - `label` string, nullable, required: A saved label, such as `Work`, `Home`, or a custom label. `null` when none is saved.
  - `phone_numbers` object[], required: The contact's phone numbers and their labels, country codes, and extensions.
    - `value` string, nullable, required: The saved value of the contact field.
    - `label` string, nullable, required: A saved label, such as `Work`, `Home`, or a custom label. `null` when none is saved.
    - `country_code` string, nullable, required: The stored country code. Values can be a region code such as `US` or a calling code such as `+1`.
    - `extension` string, nullable, required: The phone number extension.
  - `urls` object[], required: The contact's website and social profile URLs and their labels.
    - `value` string, nullable, required: The saved value of the contact field.
    - `label` string, nullable, required: A saved label, such as `Work`, `Home`, or a custom label. `null` when none is saved.
  - `addresses` object[], required: The contact's postal addresses as text values with labels.
    - `value` string, nullable, required: The saved value of the contact field.
    - `label` string, nullable, required: A saved label, such as `Work`, `Home`, or a custom label. `null` when none is saved.
  - `tags` object[], required: Tags assigned to the contact.
    - `value` string, required: The tag text.
  - `contact_notes` object[], required: Text notes saved on the contact.
    - `id` string, required: The contact note ID.
    - `text` string, required: The saved text of the contact note. Empty saved text is preserved.
    - `created_at` string, date-time, required: When the contact note was created, as an ISO 8601 timestamp.
  - `linked_notes` object[], required: Metadata for notes linked to the contact, including each note's ID, title, creation time, and type.
    - `id` string, required: The ID of the linked note.
    - `title` string, nullable, required: The custom title, otherwise the generated title, or `null` when it has neither.
    - `created_at` string, date-time, required: When the user's device created the note, as an ISO 8601 timestamp.
    - `type` 'voice_note' | 'phone_call' | 'text', required: How the linked note was captured: a recorded `voice_note`, a recorded `phone_call`, or a typed `text` note.
  - `capture_context` object, nullable, 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.
    - `recorded_at` string, date-time, nullable, required: The saved capture timestamp as ISO 8601, or `null` when unavailable. For business contacts, uses the selected recipient capture time, then recipient sharing time, contact sharing time, or contact capture time, in that order.
    - `location` string, nullable, required: The location recorded when the contact was captured.
    - `cardholder_name` string, nullable, required: The name on the recipient card, or `null` when unavailable. For business contacts, uses the earliest recipient by capture time (sharing time if capture time is absent); legacy recipients missing both times sort first. Falls back to the contact referrer card when no recipient card is recorded. This does not identify a verified meeting participant.
  - `created_at` string, date-time, nullable, required: When the contact was created, as an ISO 8601 timestamp.
  - `updated_at` string, date-time, nullable, required: When the contact was last updated, as an ISO 8601 timestamp.

## Other responses

- `400`: Bad request - Invalid query parameters or body. See `details` for each failing field
- `401`: Unauthorized - Missing or invalid API key
- `403`: Forbidden - Missing scope, insufficient permission, or the plan does not include this operation
- `404`: Not found - The contact was not found or access was denied

---

[API](https://skmtc.dev/blinq/apis/blinq-public-api.md) - [All operations](https://skmtc.dev/blinq/apis/blinq-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blinq/apis/blinq-public-api/revisions/2dedf4b14340?raw)