List license requests
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/downstream/license-requests \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
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));import requests
url = "https://public.api.live.turrisfi.com/v2/downstream/license-requests"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"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": {}
}License Requests
List License Requests
Licence applications and renewals Turris is running for you
GET
/
v2
/
downstream
/
license-requests
List license requests
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/downstream/license-requests \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
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));import requests
url = "https://public.api.live.turrisfi.com/v2/downstream/license-requests"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"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.
Authorizations
bearerrestricted-access-token
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
1-based page number
Required range:
x >= 1Example:
1
Page size (max 100)
Required range:
1 <= x <= 100Example:
50
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"
Request status
Available options:
pending, submitting, submitted, completed, failed, submission failed, rejected, canceled, archived Example:
"submitted"
What the request is for
Available options:
new, renewal, loa change, address change Example:
"renewal"
Whether the applicant is an agency entity or a producer
Available options:
entity, producer Example:
"producer"
Was this page helpful?