List License Requests

List license requests

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

const options = {method: 'GET'};

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

{
  "data": {
    "items": [
      {
        "licenseRequestId": "6627f2b5c2e0a51b8c0d4e7c",
        "requestReference": "REQ-2026-000123",
        "holderType": "producer",
        "holderId": "6627f2b5c2e0a51b8c0d4e7c",
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "stateCode": "PA",
        "requestCategory": "renewal",
        "status": "submitted",
        "licenseClassCode": "10",
        "licenseClassName": "Producer",
        "linesOfAuthority": [
          {
            "code": "16",
            "name": "Property"
          }
        ],
        "requestedAt": "2026-01-15T10:30:00.000Z",
        "groupId": "6627f2b5c2e0a51b8c0d4e90",
        "holderName": "Jon Doe",
        "licenseNumber": "1234567",
        "npn": "1234567",
        "feeAmount": 5500,
        "niprTransactionId": "TX-889900",
        "niprConfirmationNumber": "CONF-556677",
        "licenseExpirationDate": "2027-04-01T00:00:00.000Z",
        "submittedAt": "2026-01-15T10:35: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

license-requests

List license requests

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

const options = {method: 'GET'};

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

{
  "data": {
    "items": [
      {
        "licenseRequestId": "6627f2b5c2e0a51b8c0d4e7c",
        "requestReference": "REQ-2026-000123",
        "holderType": "producer",
        "holderId": "6627f2b5c2e0a51b8c0d4e7c",
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "stateCode": "PA",
        "requestCategory": "renewal",
        "status": "submitted",
        "licenseClassCode": "10",
        "licenseClassName": "Producer",
        "linesOfAuthority": [
          {
            "code": "16",
            "name": "Property"
          }
        ],
        "requestedAt": "2026-01-15T10:30:00.000Z",
        "groupId": "6627f2b5c2e0a51b8c0d4e90",
        "holderName": "Jon Doe",
        "licenseNumber": "1234567",
        "npn": "1234567",
        "feeAmount": 5500,
        "niprTransactionId": "TX-889900",
        "niprConfirmationNumber": "CONF-556677",
        "licenseExpirationDate": "2027-04-01T00:00:00.000Z",
        "submittedAt": "2026-01-15T10:35: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 licence requests raised for your entities and producers: new applications and renewals, with their current status. Each row names the entity or producer it is for through entityType and entityId, so one list covers both.

This surface is read-only. Requests are raised and progressed in the Turris agency application; there is no endpoint here that starts, pays for or submits one.

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"

status

enum<string>

Request status

Available options:

pending,

submitting,

submitted,

completed,

failed,

submission failed,

rejected,

canceled,

archived

Example:

"submitted"

requestCategory

enum<string>

What the request is for

Available options:

new,

renewal,

loa change,

address change

Example:

"renewal"

holderType

enum<string>

Whether the applicant is an agency entity or a producer

Available options:

entity,

producer

Example:

"producer"

Response

A page of license requests

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

Query Parameters

Response