List Entity Appointments

List entity appointments

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

const options = {method: 'GET'};

fetch('https://public.api.live.turrisfi.com/v2/downstream/entity-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

entity-appointments

List entity appointments

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

const options = {method: 'GET'};

fetch('https://public.api.live.turrisfi.com/v2/downstream/entity-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 your entities: which carrier, which state, which lines, and the appointment’s standing. Like entity licences, appointments are keyed on the entity’s compliance data subscription rather than on the entity id directly. An entity with no NPN has no subscription and therefore no appointments.

Narrowing

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"

Response

A page of entity 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