curl --request GET \
--url https://public.api.live.turrisfi.com/v2/upstream/termination-requests \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.api.live.turrisfi.com/v2/upstream/termination-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/upstream/termination-requests"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"items": [
{
"stateCode": "TX",
"productId": "6600a1b2c3d4e5f6a7b8c9d0",
"carrier": {
"name": "Example Mutual Insurance",
"companyCode": "12345"
},
"linesOfAuthority": [
{
"code": "16",
"name": "Property"
}
],
"status": "pending",
"processingMethod": "manual",
"requestedAt": "2026-11-10T15:04:05.000Z",
"terminationRequestId": "6672b1c2d3e4f5a6b7c8d9e1",
"agentId": "6650a1b2c3d4e5f6a7b8c9d0",
"downstreamEntityAssociationId": "6651a1b2c3d4e5f6a7b8c9d0",
"submittedAt": "2026-11-11T09:30:00.000Z",
"completedAt": "2026-11-14T16:00:00.000Z",
"canceledAt": "2026-11-16T10:00:00.000Z",
"canceledBy": {
"type": "api_client"
},
"terminationReasonCode": "1"
}
],
"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": {}
}{
"statusCode": 123,
"requestId": "<string>",
"errorType": "validation_error",
"errorMessage": [
"<string>"
],
"timestamp": "<string>",
"details": {}
}List Termination Requests
Requests to end an appointment, wherever they were made
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/upstream/termination-requests \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.api.live.turrisfi.com/v2/upstream/termination-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/upstream/termination-requests"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"items": [
{
"stateCode": "TX",
"productId": "6600a1b2c3d4e5f6a7b8c9d0",
"carrier": {
"name": "Example Mutual Insurance",
"companyCode": "12345"
},
"linesOfAuthority": [
{
"code": "16",
"name": "Property"
}
],
"status": "pending",
"processingMethod": "manual",
"requestedAt": "2026-11-10T15:04:05.000Z",
"terminationRequestId": "6672b1c2d3e4f5a6b7c8d9e1",
"agentId": "6650a1b2c3d4e5f6a7b8c9d0",
"downstreamEntityAssociationId": "6651a1b2c3d4e5f6a7b8c9d0",
"submittedAt": "2026-11-11T09:30:00.000Z",
"completedAt": "2026-11-14T16:00:00.000Z",
"canceledAt": "2026-11-16T10:00:00.000Z",
"canceledBy": {
"type": "api_client"
},
"terminationReasonCode": "1"
}
],
"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": {}
}{
"statusCode": 123,
"requestId": "<string>",
"errorType": "validation_error",
"errorMessage": [
"<string>"
],
"timestamp": "<string>",
"details": {}
}terminationRequestId. Use it with Get a Termination Request to follow one request until it completes. Termination requests are completed by Turris operations.
Query Parameters
Every filter is optional, and filters combine.| Parameter | Type | Description |
|---|---|---|
agentId | string | Only requests for this agent. Cannot be combined with downstreamEntityAssociationId. |
downstreamEntityAssociationId | string | Only the requests of the agency behind this association and of your other agencies with the same NPN, closed ones included. One open request covers every agency with that NPN, so the filter returns it whichever of them it was made for. Each row carries the current association id of the agency it was made for, which can differ from the one you sent. An archived association works too. Requests for the agency’s producers are not included: an agent request does not record the agency it was made through, so filter those by agentId. Cannot be combined with agentId. |
stateCode | string | Only requests in this state or territory, e.g. CA. |
productId | string | Only requests made under this product. |
status | string, repeatable | Only requests in any of these statuses. Repeat the parameter (?status=pending&status=submitted) or separate values with commas. |
page | number | 1-based page number. Defaults to 1. |
limit | number | Page size, max 100. Defaults to 50. |
agentId or downstreamEntityAssociationId that is not in your organization returns 404, not an empty list. Both together return 400.
The statuses are the same as for appointment requests; see List Appointment Requests.
A cancelled request stays in the list with status canceled, whether it was cancelled in the Turris dashboard, with Cancel a Termination Request, or because a product was unassigned. To leave cancelled requests out, filter by the statuses you want.
Response Shape
agentId and downstreamEntityAssociationId is set on each row: a request for an agency that has no association with you left at all carries neither. terminationReasonCode is the NIPR reason code the request was made with through Request a Termination, and is left out when there is none. submittedAt is the time of the request’s most recent move to submitted. It is kept when the request moves on, and removed if the request goes back to pending or submitting. A request that never reached submitted, and requests submitted before Turris started recording it, lack it. canceledAt and canceledBy are set only on a canceled request. canceledAt is when it was cancelled. canceledBy.type says who cancelled it: api_client when it was cancelled through this API, member for a person signed in to the Turris dashboard, admin for Turris operations, and system when Turris cancelled it on its own. Member ids and emails are not included. Requests cancelled before Turris started recording this lack both fields, so status is the signal that a request is cancelled. Fields with no value are left out.
{
"data": {
"items": [
{
"terminationRequestId": "6672b1c2d3e4f5a6b7c8d9e1",
"downstreamEntityAssociationId": "6651a1b2c3d4e5f6a7b8c9d0",
"stateCode": "CA",
"productId": "6600a1b2c3d4e5f6a7b8c9d0",
"carrier": { "name": "Example Mutual Insurance", "companyCode": "12345" },
"linesOfAuthority": [{ "code": "16", "name": "Property" }],
"status": "pending",
"processingMethod": "manual",
"requestedAt": "2026-11-10T15:04:05.000Z"
}
],
"total": 1,
"page": 1,
"limit": 50,
"totalPages": 1
},
"requestId": "abcd1234",
"timestamp": "2026-11-11T10:00:00.000Z"
}
Authorizations
Query Parameters
Only the requests of the agency behind this downstream entity association and of your other agencies with the same NPN, closed ones included: one open request covers every agency with that NPN, so the filter returns it whichever of them it was made for. Each row carries the current association id of the agency it was made for, which can differ from the one you sent. An archived association works too. Requests for the agency's producers are not included, because an agent request does not record the agency it was made through. Cannot be combined with agentId. Returns 404 when the association is not in your organization.
"6651a1b2c3d4e5f6a7b8c9d0"
Only requests in this state or territory
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 "TX"
Was this page helpful?