Skip to main content
GET
/
bridge
/
api
/
v1
/
workspaces
/
{workspaceId}
/
contacts
/
{contactId}
Retrieve a contact by ID
curl --request GET \
  --url https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/contacts/{contactId} \
  --header 'x-api-key: <x-api-key>'
{
  "id": "b6cf1c4a-2b1e-4e63-8f3e-0f9d1a2a1234",
  "workspaceId": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "languageCode": "ES",
  "createdAt": "2025-09-19T18:25:43Z",
  "updatedAt": "2025-09-19T18:25:43Z",
  "email": "<string>",
  "cellphone": "<string>",
  "customAttributes": [
    {
      "key": "<string>",
      "values": [
        "<string>"
      ]
    }
  ],
  "ownerId": "<string>"
}

Headers

​
x-api-key
string
required

Copy the API key as provided by the Bridge Console.

Path Parameters

​
workspaceId
string<uuid>
required

Unique identifier of the workspace (UUID v4).

​
contactId
string<uuid>
required

Unique identifier of the contact (UUID v4).

Response

Successful Response

​
id
string
required

Unique identifier for the contact (UUID v4).

Example:

"b6cf1c4a-2b1e-4e63-8f3e-0f9d1a2a1234"

​
workspaceId
string
required

Unique identifier of the workspace this contact belongs to

​
firstName
string
required

Contact's first name

​
lastName
string
required

Contact's last name

​
languageCode
enum<string>
required

Language code from external user

Available options:
ES,
EN
​
createdAt
string<date-time>
required

Timestamp when the contact was created

Example:

"2025-09-19T18:25:43Z"

​
updatedAt
string<date-time>
required

Timestamp when the contact was last updated

Example:

"2025-09-19T18:25:43Z"

​
email
string | null

Contact's email address

​
cellphone
string | null

Contact's cellphone address

​
customAttributes
CustomAttributeResponse · object[]

Array of custom key-value attributes

​
ownerId
string | null

Email address of the salesperson or user who owns this contact