# Turris Public API

> API documentation for the Turris Public API - enabling programmatic access to compliance data for upstream entity customers.

## Docs

- [Create Agent](https://docs.turrisfi.com/api-reference/v1/agents/create-agent.md): Add a new agent to your organization
- [Get Agent](https://docs.turrisfi.com/api-reference/v1/agents/get-agent.md): Retrieve details for a specific agent
- [List Agents](https://docs.turrisfi.com/api-reference/v1/agents/list-agents.md): Retrieve all agents associated with your organization
- [Get Agent Appointments](https://docs.turrisfi.com/api-reference/v1/appointments/agent-appointments.md): Retrieve appointment records for a specific agent
- [Get Downstream Entity Appointments](https://docs.turrisfi.com/api-reference/v1/appointments/downstream-entity-appointments.md): Retrieve appointment records for a downstream entity association
- [Get OAuth Token](https://docs.turrisfi.com/api-reference/v1/authentication/get-oauth-token.md): Exchange client credentials for a JWT access token
- [Test OAuth](https://docs.turrisfi.com/api-reference/v1/authentication/test-oauth.md): Verify that an OAuth JWT token is valid and working
- [Test Restricted Access Token](https://docs.turrisfi.com/api-reference/v1/authentication/test-restricted-access-token.md): Verify that a restricted access token is valid and working
- [Get Subscription Status](https://docs.turrisfi.com/api-reference/v1/compliance-data-subscriptions/get-status.md): Check the status of a NIPR data subscription
- [Sync Agent](https://docs.turrisfi.com/api-reference/v1/compliance-data-subscriptions/sync-agent.md): Trigger a data sync for an agent from NIPR
- [Sync Downstream Entity](https://docs.turrisfi.com/api-reference/v1/compliance-data-subscriptions/sync-downstream-entity.md): Trigger a data sync for a downstream entity association from NIPR
- [Get Agent Compliance Status](https://docs.turrisfi.com/api-reference/v1/compliance-status/agent-compliance.md): Retrieve license compliance status for an agent
- [Get Downstream Entity Compliance Status](https://docs.turrisfi.com/api-reference/v1/compliance-status/downstream-entity-compliance.md): Retrieve license compliance status for a downstream entity
- [Get Contact](https://docs.turrisfi.com/api-reference/v1/contacts/get-contact.md): Fetch a single agency contact and their business roles
- [List Contacts](https://docs.turrisfi.com/api-reference/v1/contacts/list-contacts.md): List agency contacts and their business roles across your associations
- [List Contract Container Templates](https://docs.turrisfi.com/api-reference/v1/contract-container-templates/list.md): Retrieve active ContractContainer templates for your organization
- [Add Downstream Entity](https://docs.turrisfi.com/api-reference/v1/downstream-entity-associations/add.md): Add a downstream entity directly to your network
- [Add (Dangerously)](https://docs.turrisfi.com/api-reference/v1/downstream-entity-associations/dangerously-add.md): Add a downstream entity without validation checks
- [Invite (Dangerously)](https://docs.turrisfi.com/api-reference/v1/downstream-entity-associations/dangerously-invite.md): Send an invitation without validation checks
- [Get Association](https://docs.turrisfi.com/api-reference/v1/downstream-entity-associations/get-association.md): Retrieve details for a specific downstream entity association
- [Get Sign-In URL](https://docs.turrisfi.com/api-reference/v1/downstream-entity-associations/get-sign-in-url.md): Generate a sign-in URL for a downstream entity
- [Invite Downstream Entity](https://docs.turrisfi.com/api-reference/v1/downstream-entity-associations/invite.md): Send an invitation to a new downstream entity
- [List Associations](https://docs.turrisfi.com/api-reference/v1/downstream-entity-associations/list-associations.md): Retrieve all downstream entity associations for your organization
- [Get E&O/Cyber Compliance](https://docs.turrisfi.com/api-reference/v1/eo-cyber-compliance/get-policy-compliance.md): Retrieve E&O and Cyber policy compliance statuses for a downstream entity
- [Get Producer Agreement Templates](https://docs.turrisfi.com/api-reference/v1/file-documents/get-producer-agreement-templates.md): Retrieve producer agreement templates for your organization
- [List Documents](https://docs.turrisfi.com/api-reference/v1/file-documents/list-documents.md): Retrieve file documents filtered by category
- [Upload Document](https://docs.turrisfi.com/api-reference/v1/file-documents/upload-document.md): Upload a new file document
- [Health Check](https://docs.turrisfi.com/api-reference/v1/heartbeat/health-check.md): Verify the API is operational
- [Get Agent Licenses](https://docs.turrisfi.com/api-reference/v1/licenses/agent-licenses.md): Retrieve license records for a specific agent
- [Get Downstream Entity Surplus Lines Licenses (Dangerously)](https://docs.turrisfi.com/api-reference/v1/licenses/dangerously-surplus-lines.md): Retrieve surplus lines licenses without validation
- [Get Downstream Entity Licenses](https://docs.turrisfi.com/api-reference/v1/licenses/downstream-entity-licenses.md): Retrieve license records for a downstream entity
- [Get Downstream Entity Surplus Lines Licenses](https://docs.turrisfi.com/api-reference/v1/licenses/surplus-lines.md): Retrieve surplus lines license information for downstream entities
- [Policy](https://docs.turrisfi.com/api-reference/v1/policies/get-policy.md): Retrieve a single policy by ID
- [Uploading Status](https://docs.turrisfi.com/api-reference/v1/policies/get-upload-status.md): Check the processing status of a file upload
- [Policies](https://docs.turrisfi.com/api-reference/v1/policies/list-policies.md): Retrieve all policies belonging to the authenticated upstream entity
- [Upload Policy File](https://docs.turrisfi.com/api-reference/v1/policies/upload-policy-file.md): Upload a CSV or Excel file for asynchronous policy ingestion
- [Get Product](https://docs.turrisfi.com/api-reference/v1/products/get-product.md): Retrieve details for a specific product
- [List Products](https://docs.turrisfi.com/api-reference/v1/products/list-products.md): Retrieve all products for your organization
- [Get Agent Regulatory Actions](https://docs.turrisfi.com/api-reference/v1/regulatory-actions/agent-regulatory-actions.md): Retrieve regulatory actions for a specific agent
- [Get Downstream Entity Regulatory Actions](https://docs.turrisfi.com/api-reference/v1/regulatory-actions/downstream-entity-regulatory-actions.md): Retrieve regulatory actions for a downstream entity
- [Validate NPNs](https://docs.turrisfi.com/api-reference/v1/tools/validate-npns.md): Look up National Producer Numbers via NIPR to determine if they belong to an agency (firm), agent (individual), or are not found
- [Authentication](https://docs.turrisfi.com/authentication.md): Learn how to authenticate with the Turris Public API
- [Changelog](https://docs.turrisfi.com/changelog.md): Product updates and announcements for the Turris Public API
- [Entity & Resource Definitions](https://docs.turrisfi.com/guides/entity-definitions.md): Core entities and their relationships in the Turris API
- [Environments](https://docs.turrisfi.com/guides/environments.md): Sandbox and production environments for the Turris API
- [Error Handling](https://docs.turrisfi.com/guides/error-handling.md): Understand how to handle errors from the Turris Public API
- [How to Get Started](https://docs.turrisfi.com/guides/getting-started.md): Step-by-step guide to begin using the Turris API
- [Idempotency](https://docs.turrisfi.com/guides/idempotency.md): Prevent duplicate request processing with idempotency keys
- [Pagination, Filtering, and Sorting](https://docs.turrisfi.com/guides/pagination.md): How to paginate, filter, and sort API responses
- [Rate Limiting](https://docs.turrisfi.com/guides/rate-limiting.md): Understand rate limits and how to handle them
- [Request/Response Conventions](https://docs.turrisfi.com/guides/request-response.md): Standard conventions for API requests and responses
- [Security Best Practices](https://docs.turrisfi.com/guides/security.md): Best practices for securing your Turris API integration
- [Support and Contact Information](https://docs.turrisfi.com/guides/support.md): Get help with your Turris API integration
- [Tools & Integrations](https://docs.turrisfi.com/guides/tools-and-integrations.md): Connect to the Turris Public API using your preferred tools — MCP servers, Postman collections, and more.
- [API Versioning](https://docs.turrisfi.com/guides/versioning.md): How API versioning works in the Turris Public API
- [Webhooks Overview](https://docs.turrisfi.com/guides/webhooks.md): Receive automated notifications for compliance events
- [Agent Compliance Status Change](https://docs.turrisfi.com/guides/webhooks/agent-compliance-status-change.md): Webhook event for agent compliance status changes
- [Compliance Data Synchronized](https://docs.turrisfi.com/guides/webhooks/compliance-data-synchronized.md): Webhook event for NIPR data synchronization completion
- [Agency Compliance Status Change](https://docs.turrisfi.com/guides/webhooks/downstream-entity-compliance-status-change.md): Webhook event for downstream entity (agency) compliance status changes
- [Producer Agreement Executed](https://docs.turrisfi.com/guides/webhooks/producer-agreement-executed.md): Webhook event triggered when a producer agreement is fully executed
- [Introduction](https://docs.turrisfi.com/introduction.md): Welcome to the Turris Public API documentation

## OpenAPI Specs

- [v1](https://docs.turrisfi.com/openapi/v1.json)