---
title: "Contact Liaisons"
url: "https://apipartners.mosaicinsurance.com/apis/trident-ap-is-beta/versions/018fd555-bac2-494f-872b-ac47b74f1e75/operations/getContactLiaisonForProducer"
---

> Full API specification: https://apipartners.mosaicinsurance.com/apis/trident-ap-is-beta/versions/018fd555-bac2-494f-872b-ac47b74f1e75.md

# Contact Liaisons

`GET` `/lookup/liaison`

Operation ID: `getContactLiaisonForProducer`

Returns all contact liaisons (broker contacts) registered under the specified producer. This is a read-only lookup — no data is created or modified. Each item in the response contains `contactliaisonkey`, `contactkey`, `contact`, `liaisonRole`, `contactLiaisonReference`, `firstName`, `lastName`, and `email`.

## Query parameters

- `producerContactKey` (string, required) - XFI contact key of the producer (broker company).
- `page` (integer, optional) - Page number, 1-based. Defaults to 1.
- `pageSize` (integer, optional) - Number of results per page. Defaults to 25. Maximum 100.

## Header parameters

- `X-Origination-Source` (string, required) - Identifies the calling system or channel that originated this request. Used for traceability and auditing across the platform.
- `X-Audit-UserId` (string, required) - Identifier of the end user on whose behalf this request is made, recorded for audit trail purposes.

## Responses

- `200` - Contact liaisons retrieved successfully.
- `400` - Bad request — missing producerContactKey.
- `500` - Upstream XFI service error.

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Trident APIs
  version: uat
servers:
  - url: https://apinonprod.mosaicinsurance.com
    description: Generated server url
paths:
  /lookup/liaison:
    get:
      security:
        - api_key: []
      tags:
        - LookUps
      summary: Contact Liaisons
      description: >-
        Returns all contact liaisons (broker contacts) registered under the
        specified producer. This is a read-only lookup — no data is created or
        modified.


        Each item in the response contains `contactliaisonkey`, `contactkey`,
        `contact`, `liaisonRole`, `contactLiaisonReference`, `firstName`,
        `lastName`, and `email`.
      operationId: getContactLiaisonForProducer
      parameters:
        - $ref: "#/components/parameters/XOriginationSource"
        - $ref: "#/components/parameters/XAuditUserId"
        - name: producerContactKey
          in: query
          required: true
          description: XFI contact key of the producer (broker company).
          schema:
            type: string
          example: "2000556"
        - name: page
          in: query
          required: false
          description: Page number, 1-based. Defaults to 1.
          schema:
            type: integer
            default: 1
            minimum: 1
          example: 1
        - name: pageSize
          in: query
          required: false
          description: Number of results per page. Defaults to 25. Maximum 100.
          schema:
            type: integer
            default: 25
            minimum: 1
            maximum: 100
          example: 25
      responses:
        "200":
          description: Contact liaisons retrieved successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/ContactLiaisonItem"
              examples:
                Broker Contacts:
                  summary: Liaisons for Lockton Companies
                  value:
                    - contactliaisonkey: 2596
                      contactkey: 2000556
                      contact: Lockton Companies, LLC
                      liaisonRole: Broker Contact
                      contactLiaisonReference: Ahn, Paul
                      firstName: Paul
                      lastName: Ahn
                      email: pahn@lockton.com
                    - contactliaisonkey: 2539
                      contactkey: 2000556
                      contact: Lockton Companies, LLC
                      liaisonRole: Broker Contact
                      contactLiaisonReference: Halpern, Joshua
                      firstName: Joshua
                      lastName: Halpern
                      email: joshua.halpern@lockton.com
        "400":
          description: Bad request — missing producerContactKey.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "500":
          description: Upstream XFI service error.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
security:
  - api_key: []
components:
  parameters:
    XOriginationSource:
      name: X-Origination-Source
      in: header
      required: true
      description: Identifies the calling system or channel that originated this
        request. Used for traceability and auditing across the platform.
      schema:
        type: string
      example: S01x
    XAuditUserId:
      name: X-Audit-UserId
      in: header
      required: true
      description: Identifier of the end user on whose behalf this request is made,
        recorded for audit trail purposes.
      schema:
        type: string
      example: jsmith
  schemas:
    ContactLiaisonItem:
      type: object
      description: A single contact liaison entry for a producer.
      properties:
        contactliaisonkey:
          type: integer
          description: XFI contact liaison key.
          example: 2596
        contactkey:
          type: integer
          description: XFI contact key of the producer.
          example: 2000556
        contact:
          type: string
          description: Producer company name.
          example: Lockton Companies, LLC
        liaisonRole:
          type: string
          description: Role of the liaison (e.g. Broker Contact).
          example: Broker Contact
        contactLiaisonReference:
          type: string
          description: Display name (LastName, FirstName).
          example: Ahn, Paul
        firstName:
          type: string
          example: Paul
        lastName:
          type: string
          example: Ahn
        email:
          type: string
          example: pahn@lockton.com
    ErrorResponse:
      type: object
      properties:
        error:
          $ref: "#/components/schemas/ErrorDetail"
    ErrorDetail:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
  securitySchemes:
    api_key:
      type: apiKey
      name: x-api-key
      in: header
```