Skip to main content
GET
/
v1
/
contacts
/
{contactId}
Get a contact
curl --request GET \
  --url https://public.api.live.turrisfi.com/v1/contacts/{contactId}
{
  "data": {
    "contactId": "6627f2b5c2e0a51b8c0d4e7c",
    "firstName": "Dana",
    "lastName": "Lee",
    "email": "dana.lee@acme-insurance.com",
    "isDeliverable": true,
    "associations": [
      {
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "businessRoles": [
          "Finance Manager"
        ],
        "isPrimary": true,
        "downstreamEntityAssociationId": "6627f1a9c2e0a51b8c0d4e3a"
      }
    ]
  },
  "requestId": "dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8",
  "timestamp": "2025-11-12T20:49:03.293Z"
}
Returns a single contact by id, including every agency relationship you can see them at and the business roles they hold at each. The shape is identical to a single item from GET /v1/contacts: one associations entry per agency, covering both agency-wide and market-specific relationships.

​
Path Parameters

ParameterTypeRequiredDescription
contactIdstring (ObjectId)YesThe unique identifier of the contact — the contactId returned by GET /v1/contacts.

​
Example

GET /v1/contacts/6627f2b5c2e0a51b8c0d4e7c

{
  "statusCode": 200,
  "data": {
    "contactId": "6627f2b5c2e0a51b8c0d4e7c",
    "firstName": "Dana",
    "lastName": "Lee",
    "email": "dana.lee@acme-insurance.com",
    "isDeliverable": true,
    "associations": [
      {
        "downstreamEntityAssociationId": "6627f1a9c2e0a51b8c0d4e3a",
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "businessRoles": ["Finance Manager", "Compliance Officer"],
        "isPrimary": true
      }
    ]
  },
  "timestamp": "2026-06-30T12:00:00.000Z"
}

​
Response Fields

FieldTypeDescription
contactIdstringUnique contact identifier
firstNamestringContact first name
lastNamestringContact last name
emailstringContact email address
isDeliverablebooleanWhether the email has been verified as deliverable
associationsarrayOne entry per agency you can see this contact at: downstreamEntityAssociationId? (UDA id, omitted for agency-wide), downstreamEntityId (agency id), businessRoles (string[]), isPrimary (boolean).
Returns 404 Not Found if the contact does not exist or is not visible to your organization (it has no relationship at an agency you are associated with).

Path Parameters

​
contactId
string
required

The unique identifier of the contact (the contactId returned by GET /v1/contacts).

Example:

"507f1f77bcf86cd799439011"

Response

Contact details

​
data
object
required
​
requestId
string
required

Unique request identifier

Example:

"dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8"

​
timestamp
string
required

Response timestamp

Example:

"2025-11-12T20:49:03.293Z"