List Producer Licenses

List producer licenses

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

const options = {method: 'GET'};

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

{
  "data": {
    "items": [
      {
        "licenseId": "6627f2b5c2e0a51b8c0d4e7c",
        "holderType": "entity",
        "holderId": "6610b3d2c2e0a51b8c0d1f02",
        "holderName": "Philadelphia Branch",
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "stateCode": "PA",
        "licenseNumber": "1234567",
        "licenseClassName": "Producer",
        "licenseClassCode": "10",
        "status": "active",
        "residencyStatus": "resident",
        "npn": "1234567",
        "linesOfAuthority": [
          {
            "code": "16",
            "name": "Property",
            "status": "Active",
            "issueDate": "2019-04-01T00:00:00.000Z",
            "expirationDate": "2027-04-01T00:00:00.000Z"
          }
        ],
        "issueDate": "2019-04-01T00:00:00.000Z",
        "lastRenewalDate": "2025-04-01T00:00:00.000Z",
        "nextRenewalDate": "2027-04-01T00:00:00.000Z",
        "isVoluntarySurrender": false,
        "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-licenses

List producer licenses

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

const options = {method: 'GET'};

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

{
  "data": {
    "items": [
      {
        "licenseId": "6627f2b5c2e0a51b8c0d4e7c",
        "holderType": "entity",
        "holderId": "6610b3d2c2e0a51b8c0d1f02",
        "holderName": "Philadelphia Branch",
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "stateCode": "PA",
        "licenseNumber": "1234567",
        "licenseClassName": "Producer",
        "licenseClassCode": "10",
        "status": "active",
        "residencyStatus": "resident",
        "npn": "1234567",
        "linesOfAuthority": [
          {
            "code": "16",
            "name": "Property",
            "status": "Active",
            "issueDate": "2019-04-01T00:00:00.000Z",
            "expirationDate": "2027-04-01T00:00:00.000Z"
          }
        ],
        "issueDate": "2019-04-01T00:00:00.000Z",
        "lastRenewalDate": "2025-04-01T00:00:00.000Z",
        "nextRenewalDate": "2027-04-01T00:00:00.000Z",
        "isVoluntarySurrender": false,
        "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 state licences held by the producers associated with your entities. Scope follows the association, not the producer: you see the licences of producers associated with your entities, and each association carries its own compliance data subscription. A producer who leaves your agency stops appearing once the association is archived, without their licence records changing.

Narrowing

producerId limits the list to one producer, downstreamEntityId to producers at one entity, and stateCode / status filter within either.

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>

License status

Available options:

active,

inactive

Example:

"active"

producerId

string

Narrow to a single producer. Returns an empty page if the producer is not associated with your organization, which is the same response as a producer that does not exist.

Example:

"6627f2b5c2e0a51b8c0d4e7c"

Response

A page of producer licenses

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