> ## Documentation Index > Fetch the complete documentation index at: https://docs.turrisfi.com/llms.txt > Use this file to discover all available pages before exploring further. # List Entity Licenses > The licences held by your legal entities Returns the state licences held by your entities, sourced from NIPR and refreshed by Turris. **Entity licences are keyed on a compliance data subscription, not on an entity id.** Each of your entities has its own subscription, and the licence rows hang off that. You do not need to handle this — the API resolves it — but it explains why a brand-new entity with no NPN never returns licences: no NPN means no subscription, and no subscription means nothing to sync. ## Narrowing `downstreamEntityId` limits the list to one entity. `stateCode` and `status` filter within it. ## OpenAPI ````yaml openapi/v2.json GET /v2/downstream/entity-licenses openapi: 3.0.0 info: title: Turris Public API description: API for managing insurance compliance data version: 2.0.0 contact: {} servers: - url: https://public.api.live.turrisfi.com description: Production - url: https://public.api.sandbox.turrisfi.com description: Sandbox security: [] tags: [] paths: /v2/downstream/entity-licenses: get: tags: - downstream/licenses summary: List entity licenses description: >- Returns the licenses held by your legal entities across your organization: your entity plus every branch beneath it. Narrow with downstreamEntityId, stateCode or status. Each row names its holder, because a license record itself identifies only the NIPR subscription it came from. Results are paginated and ordered by state. operationId: LicensesController_getEntityLicenses_v2 parameters: - name: page required: false in: query description: 1-based page number schema: minimum: 1 default: 1 example: 1 type: number - name: limit required: false in: query description: Page size (max 100) schema: minimum: 1 maximum: 100 default: 50 example: 50 type: number - name: downstreamEntityId required: false in: query description: >- 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. schema: example: 6610b3d2c2e0a51b8c0d1f02 type: string - name: stateCode required: false in: query description: Two-letter state or territory code schema: example: PA type: string enum: - 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 - name: status required: false in: query description: License status schema: example: active type: string enum: - active - inactive responses: '200': description: A page of entity licenses content: application/json: schema: type: object properties: data: type: object properties: items: type: array items: $ref: '#/components/schemas/DownstreamLicenseResponse' total: type: integer description: Total rows matching the query across all pages example: 137 page: type: integer description: 1-based page number example: 1 limit: type: integer description: Page size example: 50 totalPages: type: integer description: Number of pages, or 0 when there are no rows example: 3 required: - items - total - page - limit - totalPages requestId: type: string description: Unique request identifier example: dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8 timestamp: type: string description: Response timestamp example: '2025-11-12T20:49:03.293Z' required: - data - requestId - timestamp '400': description: Invalid query parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponseDto' '401': description: Invalid or missing auth token content: application/json: schema: $ref: '#/components/schemas/ErrorResponseDto' '403': description: Your organization is not entitled to the public API content: application/json: schema: $ref: '#/components/schemas/ErrorResponseDto' '404': description: downstreamEntityId is not in your organization content: application/json: schema: $ref: '#/components/schemas/ErrorResponseDto' components: schemas: DownstreamLicenseResponse: type: object properties: licenseId: type: string description: Unique identifier of the license example: 6627f2b5c2e0a51b8c0d4e7c holderType: type: string description: Whether an agency entity or a producer holds this license enum: - entity - producer example: entity holderId: type: string description: >- The entity id for an entity license, the producer id for a producer license example: 6610b3d2c2e0a51b8c0d1f02 holderName: type: string description: Name of the holder example: Philadelphia Branch downstreamEntityId: type: string description: The agency this license sits under, whichever type holds it example: 6610b3d2c2e0a51b8c0d1f02 stateCode: type: string description: State or territory that issued the license enum: - 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 example: PA licenseNumber: type: string description: License number as issued example: '1234567' licenseClassName: type: string description: License class name example: Producer licenseClassCode: type: string description: License class code example: '10' status: type: string description: License status enum: - active - inactive example: active residencyStatus: type: string description: Resident or non-resident enum: - resident - non-resident - non-resident-no-home-state example: resident npn: type: string description: The NPN the license was issued against example: '1234567' linesOfAuthority: description: Lines of authority on this license type: array items: $ref: '#/components/schemas/DownstreamLineOfAuthorityResponse' issueDate: type: string description: ISO 8601 issue date example: '2019-04-01T00:00:00.000Z' lastRenewalDate: type: string description: ISO 8601 last renewal date example: '2025-04-01T00:00:00.000Z' nextRenewalDate: type: string description: ISO 8601 next renewal date example: '2027-04-01T00:00:00.000Z' isVoluntarySurrender: type: boolean description: >- Whether the holder recorded a decision not to renew. Absent means no decision was recorded, which is not the same as a decision to renew. example: false updatedAt: type: string description: ISO 8601 last-update timestamp example: '2026-06-02T08:12:44.000Z' required: - licenseId - holderType - holderId - holderName - downstreamEntityId - stateCode - licenseNumber - licenseClassName - licenseClassCode - status - residencyStatus - npn - linesOfAuthority ErrorResponseDto: type: object properties: statusCode: type: number description: HTTP status code requestId: type: string description: Unique request identifier for debugging errorType: type: string description: >- Machine-readable error classification. Branch on this rather than on `errorMessage`, which is prose and may change. Authentication failures returned by our identity provider are forwarded verbatim, so a 401 can carry a code outside this list; treat an unrecognised value as a generic failure of its HTTP status. enum: - conflict - contact_not_authorized - document_exceeds_page_limit - downstream_entity_member_exists - duplicate_external_id_error - duplicate_member_email - duplicate_producer_code_error - forbidden - gateway_timeout - inactive_email - internal_server_error - invalid_email - invalid_email_for_invites - invalid_organization_category - invalid_organization_slug - invalid_phone_number - invalid_token - invite_limit_reached - jwt_invalid - m2m_client_not_found - not_found - organization_already_exists - organization_slug_already_used - payment_required - producer_agreement_required - product_feature_subscription_required - service_unavailable - session_authorization_error - some_custom_error_string - throttled - too_many_requests - unauthorized - unauthorized_client - unexpected_400_stytch_error - unexpected_403_stytch_error - unexpected_404_stytch_error - unexpected_error - unexpected_stytch_error - unprocessable_entity - validation_error example: validation_error errorMessage: description: Array of error messages type: array items: type: string timestamp: type: string description: ISO timestamp when the error occurred details: type: object description: Additional error context required: - statusCode - requestId - errorType - errorMessage - timestamp DownstreamLineOfAuthorityResponse: type: object properties: code: type: string description: Line-of-authority code example: '16' name: type: string description: Line-of-authority name example: Property status: type: string description: Status of this line of authority example: Active issueDate: type: string description: ISO 8601 issue date example: '2019-04-01T00:00:00.000Z' expirationDate: type: string description: ISO 8601 expiration date example: '2027-04-01T00:00:00.000Z' required: - code - name ```` ## Related topics - [Entity Licensing Position by State](/api-reference/v2/downstream/license-overview/entity-license-overview.md) - [List License Requests](/api-reference/v2/downstream/license-requests/list-license-requests.md) - [List Producer Licenses](/api-reference/v2/downstream/licenses/producer-licenses.md)