Actions Required

List licenses needing attention

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

const options = {method: 'GET'};

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

{
  "data": {
    "items": [
      {
        "licenseId": "6627f2b5c2e0a51b8c0d4e7c",
        "holderType": "producer",
        "holderId": "6627f2b5c2e0a51b8c0d4e7c",
        "holderName": "Jon Doe",
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "stateCode": "PA",
        "licenseNumber": "1234567",
        "licenseClassCode": "10",
        "licenseClassName": "Producer",
        "expirationStatus": "expiring",
        "npn": "1234567",
        "nextRenewalDate": "2026-09-30T00:00:00.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

actions-required

List licenses needing attention

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

const options = {method: 'GET'};

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

{
  "data": {
    "items": [
      {
        "licenseId": "6627f2b5c2e0a51b8c0d4e7c",
        "holderType": "producer",
        "holderId": "6627f2b5c2e0a51b8c0d4e7c",
        "holderName": "Jon Doe",
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "stateCode": "PA",
        "licenseNumber": "1234567",
        "licenseClassCode": "10",
        "licenseClassName": "Producer",
        "expirationStatus": "expiring",
        "npn": "1234567",
        "nextRenewalDate": "2026-09-30T00:00:00.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 licences that need something done about them: active licences inside their state renewal window, plus licences already past due where a late-renewal or reinstatement path is still open. Entity-held and producer-held licences arrive in one list, soonest expiry first. Each row carries holderType, which tells you whether it refers to an entity or a producer. Filter with holderType to get one side only. expirationStatus is either expiring or expired, and there is no third value. A licence outside its renewal window does not appear on this list at all, and there is no row for a licence you do not hold: this list is work on licences you have, not a gap analysis against a requirement set. Licences you have marked as not-to-be-renewed are excluded. The agency surface has no webhooks, so polling this endpoint is the documented substitute (see Agency API).

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"

holderType

enum<string>

Restrict to entity-held or producer-held licenses. Both are returned by default.

Available options:

entity,

producer

Example:

"producer"

Response

A page of licenses needing attention

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

Licensing Overview

Appointments

License Requests

Compliance Configurations

Markets

Corporate Registrations

Documents

Surplus Lines

Actions Required

Query Parameters

Response