List your own contacts on a market
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}/entity-contacts \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}/entity-contacts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}/entity-contacts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"items": [
{
"contactId": "6627f2b5c2e0a51b8c0d4e7c",
"firstName": "Jon",
"lastName": "Doe",
"email": "example@test.com",
"isDeliverable": true,
"scopes": [
{
"downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
"businessRoles": [
"Finance Manager"
],
"isPrimary": true,
"upstreamDownstreamAssociationId": "6627f1a9c2e0a51b8c0d4e3a"
}
],
"createdAt": "2025-01-15T10:30:00.000Z",
"updatedAt": "2025-06-02T08:12:44.000Z"
}
],
"total": 137,
"page": 1,
"limit": 50,
"totalPages": 3
},
"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": {}
}{
"statusCode": 123,
"requestId": "<string>",
"errorType": "validation_error",
"errorMessage": [
"<string>"
],
"timestamp": "<string>",
"details": {}
}Markets
List Your Own Contacts on a Market
Your agency’s people, scoped to one carrier relationship
GET
/
v2
/
downstream
/
markets
/
{upstreamDownstreamAssociationId}
/
entity-contacts
List your own contacts on a market
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}/entity-contacts \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}/entity-contacts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}/entity-contacts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"items": [
{
"contactId": "6627f2b5c2e0a51b8c0d4e7c",
"firstName": "Jon",
"lastName": "Doe",
"email": "example@test.com",
"isDeliverable": true,
"scopes": [
{
"downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
"businessRoles": [
"Finance Manager"
],
"isPrimary": true,
"upstreamDownstreamAssociationId": "6627f1a9c2e0a51b8c0d4e3a"
}
],
"createdAt": "2025-01-15T10:30:00.000Z",
"updatedAt": "2025-06-02T08:12:44.000Z"
}
],
"total": 137,
"page": 1,
"limit": 50,
"totalPages": 3
},
"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": {}
}{
"statusCode": 123,
"requestId": "<string>",
"errorType": "validation_error",
"errorMessage": [
"<string>"
],
"timestamp": "<string>",
"details": {}
}Returns your contacts scoped to this market — the people at your agency this carrier deals with.
The counterpart to List a Market’s Contacts, which returns the carrier’s people. Both are on the same relationship and they are different sets.
Agency-wide contacts, which are visible on every market, are not included here; use List Contacts for those.
Authorizations
bearerrestricted-access-token
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The unique identifier of the market (the upstreamDownstreamAssociationId returned by the List Markets endpoint).
Example:
"6627f1a9c2e0a51b8c0d4e3a"
Query Parameters
1-based page number
Required range:
x >= 1Example:
1
Page size (max 100)
Required range:
1 <= x <= 100Example:
50
Was this page helpful?