List Your Own Contacts on a Market

List your own contacts on a market

curl --request GET \
  --url https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}/entity-contacts

const options = {method: 'GET'};

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));

{
  "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": {}
}

GET

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

const options = {method: 'GET'};

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));

{
  "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.

Path Parameters

upstreamDownstreamAssociationId

string

required

The unique identifier of the market (the upstreamDownstreamAssociationId returned by the List Markets endpoint).

Example:

"6627f1a9c2e0a51b8c0d4e3a"

Query Parameters

page

number

default:1

1-based page number

Required range: x >= 1

Example:

1

limit

number

default:50

Page size (max 100)

Required range: 1 <= x <= 100

Example:

50

Response

A page of your contacts on this market

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

Licensed Entities

Producers

Contacts

Licenses

Actions Required

Licensing Overview

Appointments

License Requests

Compliance Configurations

Markets

Corporate Registrations

Documents

Surplus Lines

List Your Own Contacts on a Market

Path Parameters

Query Parameters

Response