List Producer Appointments

List producer appointments

curl --request GET \
  --url https://public.api.live.turrisfi.com/v2/downstream/producer-appointments

const options = {method: 'GET'};

fetch('https://public.api.live.turrisfi.com/v2/downstream/producer-appointments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "items": [
      {
        "appointmentId": "6627f2b5c2e0a51b8c0d4e7c",
        "holderType": "entity",
        "holderId": "6610b3d2c2e0a51b8c0d1f02",
        "holderName": "Philadelphia Branch",
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "stateCode": "PA",
        "carrierName": "Example Mutual Insurance Company",
        "companyCode": "12345",
        "status": "appointed",
        "lineOfAuthorityName": "Property",
        "lineOfAuthorityCode": "16",
        "npn": "1234567",
        "terminationReason": "Voluntary",
        "countyName": "Bucks",
        "statusChangeDate": "2025-04-01T00:00:00.000Z",
        "renewalDate": "2027-04-01T00:00:00.000Z",
        "updatedAt": "2026-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

producer-appointments

List producer appointments

curl --request GET \
  --url https://public.api.live.turrisfi.com/v2/downstream/producer-appointments

const options = {method: 'GET'};

fetch('https://public.api.live.turrisfi.com/v2/downstream/producer-appointments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "items": [
      {
        "appointmentId": "6627f2b5c2e0a51b8c0d4e7c",
        "holderType": "entity",
        "holderId": "6610b3d2c2e0a51b8c0d1f02",
        "holderName": "Philadelphia Branch",
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "stateCode": "PA",
        "carrierName": "Example Mutual Insurance Company",
        "companyCode": "12345",
        "status": "appointed",
        "lineOfAuthorityName": "Property",
        "lineOfAuthorityCode": "16",
        "npn": "1234567",
        "terminationReason": "Voluntary",
        "countyName": "Bucks",
        "statusChangeDate": "2025-04-01T00:00:00.000Z",
        "renewalDate": "2027-04-01T00:00:00.000Z",
        "updatedAt": "2026-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 the carrier appointments held by producers associated with your entities.

Narrowing

producerId, downstreamEntityId, stateCode and status.

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

downstreamEntityId

string

Narrow the results to a single entity in your organization. Defaults to your whole subtree (your entity plus every branch beneath it). Returns 404 if the id is not in your subtree.

Example:

"6610b3d2c2e0a51b8c0d1f02"

stateCode

enum<string>

Two-letter state or territory code

Available options:

AL,

AK,

AZ,

AR,

CA,

CO,

CT,

DE,

FL,

GA,

HI,

ID,

IL,

IN,

IA,

KS,

KY,

LA,

ME,

MD,

MA,

MI,

MN,

MS,

MO,

MT,

NE,

NV,

NH,

NJ,

NM,

NY,

NC,

ND,

OH,

OK,

OR,

PA,

RI,

SC,

SD,

TN,

TX,

UT,

VT,

VA,

WA,

WV,

WI,

WY,

GU,

PR,

VI,

DC

Example:

"PA"

status

enum<string>

Appointment status

Available options:

terminated,

appointed

Example:

"appointed"

companyCode

string

The carrier's company code. Filter on this rather than carrierName, which comes off the NIPR record unnormalised and can spell one carrier several ways.

Example:

"12345"

producerId

string

Narrow to a single producer. Returns an empty page if the producer is not associated with your organization.

Example:

"6627f2b5c2e0a51b8c0d4e7c"

Response

A page of producer appointments

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

Narrowing

Query Parameters

Response

​Narrowing

Query Parameters

Response

Narrowing