Skip to main content
GET
/
v1
/
policies
/
{policyId}
cURL
curl --request GET \
  --url https://public.api.live.turrisfi.com/v1/policies/{policyId}
{
  "data": {
    "_id": "6650a1b2c3d4e5f6a7b8c9d0",
    "policyNumber": "POL-2025-001",
    "currentStatus": "active",
    "riskStateCode": "CA",
    "entityMatchStatus": "auto matched",
    "productMatchStatus": "unmatched",
    "transactionCount": 3,
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-01-15T10:31:45.000Z",
    "insuredEntityName": "Acme Corp",
    "agencyName": "Premier Insurance Agency",
    "agencyNpn": "12345678",
    "agencyFein": "12-3456789",
    "agencyLicenseNumber": "ABC-123456",
    "agencyLicensedStateCode": "CA",
    "agentName": "John Smith",
    "agentNpn": "87654321",
    "agentLicenseNumber": "LIC-789012",
    "agentLicensedState": "TX",
    "carrierName": "National Insurance Co",
    "lineOfBusiness": "Commercial Lines",
    "producerName": "Jane Doe",
    "producerCode": "PROD-001",
    "productName": "General Liability",
    "productCode": "GL-100",
    "effectiveDate": "2025-01-15T00:00:00.000Z",
    "expiryDate": "2026-01-15T00:00:00.000Z",
    "premiumAmountInUSD": 5000,
    "aggregateCoverageInUSD": 1000000,
    "coveragePerClaimInUSD": 500000,
    "filingNumber": "FIL-2025-001",
    "slaNumber": "SLA-2025-001",
    "externalBillingId": "BILL-2025-001",
    "licenseNumber": "LIC-001",
    "npn": "11223344"
  },
  "requestId": "dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8",
  "timestamp": "2025-11-12T20:49:03.293Z"
}
Returns a single policy by its unique identifier. The policy must belong to the authenticated upstream entity.

​
Path Parameters

ParameterTypeRequiredDescription
policyIdstringYesUnique identifier of the policy (MongoDB ObjectId)

​
Response Shape

All successful responses are wrapped in the standard response envelope. See Request/Response Conventions.
{
  "statusCode": 200,
  "data": {
    "_id": "6650a1b2c3d4e5f6a7b8c9d0",
    "policyNumber": "POL-2025-001",
    "currentStatus": "active",
    "riskStateCode": "CA",
    "agencyName": "Premier Insurance Agency",
    "agencyNpn": "12345678",
    "agencyFein": "12-3456789",
    "agentName": "John Smith",
    "agentNpn": "87654321",
    "carrierName": "National Insurance Co",
    "lineOfBusiness": "Commercial Lines",
    "producerName": "Jane Doe",
    "productName": "General Liability",
    "insuredEntityName": "Acme Corp",
    "effectiveDate": "2025-01-15T00:00:00.000Z",
    "expiryDate": "2026-01-15T00:00:00.000Z",
    "premiumAmountInUSD": 5000,
    "aggregateCoverageInUSD": 1000000,
    "coveragePerClaimInUSD": 500000,
    "entityMatchStatus": "auto matched",
    "productMatchStatus": "unmatched",
    "transactionCount": 3,
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-01-15T10:31:45.000Z"
  },
  "timestamp": "2025-01-15T10:31:50.000Z"
}

​
Response Fields

The response object contains the same fields as each item in List Policies. See that page for the full field reference, including matching status values.

​
Error Scenarios

​
Bad Request (400)

Returned when policyId is not a valid MongoDB ObjectId format. 
{
  "statusCode": 400,
  "errorType": "validation_error",
  "errorMessage": ["policyId must be a mongodb id"],
  "requestId": "dev-abc123",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

​
Policy Not Found (404)

Returned when policyId doesn’t exist or belongs to a different upstream entity. 
{
  "statusCode": 404,
  "errorType": "not_found",
  "errorMessage": ["Policy not found"],
  "requestId": "dev-abc123",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

​
Unauthorized (401)

Missing or invalid authentication token. See Authentication.

Path Parameters

​
policyId
string
required

Unique identifier of the policy

Example:

"6650a1b2c3d4e5f6a7b8c9d0"

Response

Policy details

​
data
object
required
​
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"