curl --request GET \
--url https://public.api.live.turrisfi.com/v2/upstream/appointment-requests \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.api.live.turrisfi.com/v2/upstream/appointment-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/appointment-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",
"appointmentRequestId": "6672b1c2d3e4f5a6b7c8d9e0",
"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"
}
}
],
"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 Appointment Requests
Appointment requests for your agents and agencies, wherever they were made
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/upstream/appointment-requests \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.api.live.turrisfi.com/v2/upstream/appointment-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/appointment-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",
"appointmentRequestId": "6672b1c2d3e4f5a6b7c8d9e0",
"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"
}
}
],
"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": {}
}appointmentRequestId. Use it with Get an Appointment Request to follow one request until it completes.
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. TX. |
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 (?status=pending,submitted). |
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.
Statuses
| Status | Meaning |
|---|---|
pending | Requested, not yet filed with the state. |
submitting | Being filed with the state. |
submitted | Filed with the state, waiting for the outcome. |
completed | The request is complete. |
failed | The request failed. |
submission failed | Filing with the state failed. |
rejected | The state rejected the request. |
canceled | The request was cancelled. |
archived | The request was archived. |
pending, submitting and submitted are in progress. Every other status is final, so stop polling a request once it reaches one of them. The Appointment Request Status Change webhook tells you about each change without polling.
A cancelled request stays in the list with status canceled, whether it was cancelled in the Turris dashboard, with Cancel an Appointment Request, or because a product was unassigned. To leave cancelled requests out, filter by the statuses you want.
Turris operations moves requests between statuses today. When filing is automated, requests move through the same statuses on their own; no new value is added.
What the list leaves out
- Renewal and line-of-authority change requests.
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. Fields with no value are left out. 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, so status is the signal that a request has been filed. completedAt is set on completion, but some older completed requests lack it, so status is the completion signal. 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.
{
"data": {
"items": [
{
"appointmentRequestId": "6672b1c2d3e4f5a6b7c8d9e0",
"agentId": "6650a1b2c3d4e5f6a7b8c9d0",
"stateCode": "TX",
"productId": "6600a1b2c3d4e5f6a7b8c9d0",
"carrier": { "name": "Example Mutual Insurance", "companyCode": "12345" },
"linesOfAuthority": [{ "code": "16", "name": "Property" }],
"status": "submitted",
"processingMethod": "manual",
"requestedAt": "2026-11-10T15:04:05.000Z",
"submittedAt": "2026-11-11T09:30:00.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?