Get Contact

Get a contact

curl --request GET \
  --url https://public.api.live.turrisfi.com/v1/contacts/{contactId}

const options = {method: 'GET'};

fetch('https://public.api.live.turrisfi.com/v1/contacts/{contactId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "contactId": "6627f2b5c2e0a51b8c0d4e7c",
    "firstName": "Jon",
    "lastName": "Doe",
    "email": "example@test.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"
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

GET

contacts

{contactId}

Get a contact

curl --request GET \
  --url https://public.api.live.turrisfi.com/v1/contacts/{contactId}

const options = {method: 'GET'};

fetch('https://public.api.live.turrisfi.com/v1/contacts/{contactId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "contactId": "6627f2b5c2e0a51b8c0d4e7c",
    "firstName": "Jon",
    "lastName": "Doe",
    "email": "example@test.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"
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

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

Parameter	Type	Required	Description
`contactId`	string (ObjectId)	Yes	The unique identifier of the contact — the `contactId` returned by `GET /v1/contacts`.

Example

GET /v1/contacts/6627f2b5c2e0a51b8c0d4e7c

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

Response Fields

Field	Type	Description
`contactId`	string	Unique contact identifier
`firstName`	string	Contact first name
`lastName`	string	Contact last name
`email`	string	Contact email address
`isDeliverable`	boolean	Whether the email has been verified as deliverable
`associations`	array	One 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 the List Contacts endpoint).

Example:

"507f1f77bcf86cd799439011"

Response

Contact details

data

object

required

Show child attributes

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"

Start Here

Shared Endpoints

Products

Agencies You Appoint

Contract Container Templates

Agents

Contacts

Market Contacts

Licenses

Appointments

Compliance Data Subscriptions

Compliance Status

File Documents

Policy Ingestion

Policy Transactions

Surplus Lines Filings

Webhooks

E&O/Cyber Compliance

Regulatory Actions

Tools

Path Parameters

Example

Response Fields

Path Parameters

Response

​Path Parameters

​Example

​Response Fields

Path Parameters

Response

Path Parameters

Example

Response Fields